Skip to main content

Launch and initialize

Work from the directory containing your configured Compose file, normally /opt/nusaas. The guided installer performs first-time migration and core seeding; do not repeat its seeding blindly.

For a new manual installation only:

docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
# API startup applies forward migrations. Seed core configuration only once.
docker compose exec api php artisan db:seed --force
docker compose exec api php artisan scout:sync-index-settings
curl -f https://api.yourdomain.com/api/health

Before first seeding, do not add INITIAL_ADMIN_* credentials and leave SEED_DEFAULT_SUBSCRIPTION_DATA=false; do not enable demo or sample seeders. The public image does not create an internal system-admin account. Register a business owner in the web application, verify their email and complete business/module onboarding. Invite other users from the ERP after setup. SMTP must work for verification; logging email to a server file is not mail delivery.

Check services without printing environment secrets:

docker compose logs --since=10m api worker cron ws

Verify a logo upload survives API container replacement, search is usable, a harmless queued task completes and WebSockets connect. Configure each integration with your own account, permissions and provider prerequisites before enabling it. No payment, WhatsApp pairing or fiscal transmission occurs merely by starting the containers.

For routine upgrades, use Backups and maintenance. API startup migrates; do not rerun broad seeders against live tenant data. If applying a migration explicitly, use php artisan migrate --force, without --seed.

When using optional overlays, include the same -f arguments in every Compose command so that status, updates and backups address the intended stack.

Configure business integrations​

Continue with Business integrations for your own M-Pesa account, KRA OSCU sandbox/device setup and queue checks. Integration credentials are configured in ERP settings; the installer does not activate them.