Works locally, but teammates cannot connect
The default application binds to 127.0.0.1:3000. Remote users should use your HTTPS reverse proxy. Check DNS, TLS, the proxy upstream, and firewall rules. See production deployment.
Compose reports a missing database password
Run commands from the directory containing compose.yaml and check that .env contains a nonempty DB_PASSWORD. An export in another terminal does not persist configuration for a new session.
The first image pull is slow
The first deployment downloads the app and database images. Check progress with docker compose pull, and confirm network access and available disk space. The prebuilt-image path does not compile the product locally; source builds are an optional development workflow.
MCP connects, but projects are missing
Check project membership for the token’s account, its project allowlist, access level, IP restrictions, and expiration. List accessible projects before reading a specific target.
An agent write has an unclear outcome
Read the actual work item, document, or plan again. A network timeout does not prove the write failed. Avoid blindly repeating creates or updates; inspect current data and audit records before deciding to retry.
The assistant cannot find a document
Confirm that your account can open the document directly and that the conversation uses the correct project scope. Check the embedding provider, retrieval status, and model configuration. If search returns nothing, open the document directly to check its contents.
Notifications or streamed answers arrive late
Check proxy response buffering and short timeouts on event streams. With Caddy, use flush_interval -1; with nginx, disable buffering for the relevant responses.
Attachment uploads fail
Check the application’s attachment limit, proxy request size limit, data volume capacity, and write permissions. Leave room in the proxy limit for request overhead.
Change language or appearance
Open personal preferences in Feronavi to switch between Chinese and English or change the color theme.