Kawan Docs

Account & sync

Self-hosting

Website and app

The Apache Docker image includes the landing page and documentation. You can host the whole website with one Coolify application resource, alongside your database.

Set the resource's Domains to https://kawanapp.com and keep APP_URL=https://kawanapp.com/app. Use your own domain if it is different. The root address opens the landing page. Choose Log in to open the app under /app/. The documentation stays at /docs/.

If you previously hosted the app alone, deploy the updated image and change Domains to the root address. Keep /app in APP_URL. Try a private window if your browser still redirects the root address to login.

Database connection

If you host Kawan yourself, it checks the database connection before starting the app. The check uses your DATABASE_URL when you set one. Otherwise, it uses your individual DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME and DB_PASSWORD settings.

On Coolify, use the database's internal connection details and put the app and database on the same destination network. Wait until the database is healthy, then deploy the app.

If the logs say Unable to contact your database., check those settings and deploy again. The messages Serving the app under /app. and APP_KEY already set. are normal.

Grant instance administrator access

To let a user manage all users across every account in your installation, run this in the Kawan app container's terminal. Replace the email address with an existing Kawan login:

php artisan kawan:instance-admin [email protected]

The user can then open Settings → All users. This grants instance administrator access without changing their password or their role within their own account. It does not create a new login. Register or invite the user first if they do not have one.

You can grant this access to other users from All users → Edit permissions. See All users for the available actions.

Last updated 19 November 2026