Troubleshooting
License key invalid or expired
Confirm PALACE_LICENSE_KEY is set with no surrounding quotes or whitespace. Keys are Ed25519-signed and verified on startup; an "expired" error means the embedded expiry has passed — check your subscription status in the billing portal, which re-issues a fresh key.
Database connection fails
Verify DATABASE_URL points at a reachable Postgres with the pgvector extension available. Use only ASCII characters in the password (the URL is parsed as UTF-8), and make sure the database accepts connections from the server's host.
Port 8080 already in use
Another process is bound to :8080. Stop it, or override the bind address via env (for the binary) / remap the published port in your docker-compose.yml.
Migrations on startup
Migrations run automatically and are forward-only (IF NOT EXISTS). If startup fails mid-migration, check that the database user owns the schema and has permission to create tables and extensions.
ARM / Apple Silicon
The Docker image and binary support Linux, macOS, and ARM64. On Apple Silicon, ensure Docker pulls the matching architecture and that your Postgres image is also ARM-compatible.
Still stuck? Reach us through the contact form.