Frequently Asked Questions

Installation & Setup

What is Karrio Insiders?

Karrio Insiders is the enterprise version of Karrio, providing advanced shipping management capabilities with admin controls, multi-organization support, and additional features beyond the open-source version.

What are the system requirements?

• Docker and Docker Compose
• At least 2GB RAM
• 10GB free disk space
• Linux/macOS/Windows with Docker support

How do I get access to Karrio Insiders?

You need a valid subscription and GitHub Personal Access Token with read:packages scope to access the private container images.

Features & Capabilities

What white labeling options are available?

Currently, you can customize:

• Platform name
• Website URL

Advanced customization (logos, colors, themes) requires self-hosting and code modifications.

Which carriers are supported?

Karrio supports 50+ carriers including FedEx, UPS, DHL, USPS, Canada Post, and many regional carriers. You can enable/disable specific carriers through the admin panel.

Can I use my own domain?

Yes, but it requires manual server configuration including DNS setup, SSL certificates, and environment variable updates. This is not available through the admin interface.

Administration

How do I create admin users?

1. Log in with the default admin account
2. Navigate to Admin → User Management
3. Click “Invite User” and select “Admin” role
4. The user will receive an email invitation

How do I manage feature flags?

Feature flags can be managed through:

1. Admin dashboard: Admin → Platform → Features
2. Environment variables
3. Django settings (for self-hosted deployments)

How do I backup my data?

For self-hosted deployments:

• Use PostgreSQL’s pg_dump for database backups
• Back up uploaded files and static assets
• Save environment variables and configurations

Troubleshooting

Services won’t start after installation

Check:

1. Docker is running
2. GitHub authentication is working
3. Ports 3000 and 5002 are available
4. Review logs with docker compose logs

Can’t access admin dashboard

Ensure:

1. You’re logged in as a staff user
2. ADMIN_DASHBOARD feature flag is enabled
3. Your user has is_staff=True permission

Feature flags not updating

1. Clear browser cache
2. Restart services: docker compose restart
3. Check environment variables are correctly set

Support

How do I get help?

• Documentation: docs.karrio.io
• Community Discord: Join here
• Email support: support@karrio.io (subscribers only)

Can I contribute to the documentation?

Yes! The documentation is open source. You can contribute improvements, corrections, and additions through our GitHub repository.

Is there a staging environment?

You’ll need to set up your own staging environment. We recommend using the same Docker setup but with a separate database and domain.