The recommended path is:
bun install
bun setup
The wizard (@platform/setup) walks through mode, MySQL, Redis, S3, email, domain, and admin user, then writes .env, runs migrations, and can start Compose.
Requirements
- Bun
- Docker (for MySQL/Redis or full Compose)
- S3-compatible object storage
- Sequenzy or Resend for transactional email (
EMAIL_PROVIDER)
Feature flags
With PLATFORM_MODE=selfhost:
- Core product is unlimited (no SaaS plan caps)
- Basic branding is free; full white-label needs a one-time Felagar license (
FELAGAR_LICENSE_KEYor Settings → License) - Domains, OAuth connectors, and RealtimeKit are operator-arranged (docs only; bring your own apps/credentials)
- Settings → Billing is hidden on self-host
After install
- Open the admin login URL the wizard prints
- Complete agency onboarding if prompted
- Invite staff from Settings → Team and clients from Clients
- Create a project, then use Kanban, files, designs, tickets, and chat
See the repository docs/self-hosting.md and docs/payments-plans.md for the license and env reference.