FAQ
What do I need on the server?
Section titled “What do I need on the server?”PostgreSQL, the NovaCode API + dashboard, and network access for your users. Cursor and/or Claude CLIs should be available on the host (or in your container) so agents can run; you authenticate them from Settings.
How do workspaces relate to disk paths?
Section titled “How do workspaces relate to disk paths?”Each workspace points at a directory the server can read and write. Paths must be allowed by your deployment (e.g. bind mounts in Docker). The file browser and Git commands never leave that workspace root.
Where is my code sent?
Section titled “Where is my code sent?”Application data stays in your database and filesystem. When you invoke Cursor or Claude, those tools follow their own vendor policies—NovaCode does not replace those clients. See Privacy.
What about API tokens?
Section titled “What about API tokens?”JWTs protect the web UI. Separate API tokens can be minted for scripts or automation; store them like passwords.
Can I run without Docker?
Section titled “Can I run without Docker?”Yes, if you match the app repo’s Node and PostgreSQL expectations—use the application README as the source of truth for exact versions and scripts.
Health checks
Section titled “Health checks”GET /api/health returns uptime and database reachability without authentication—suitable for Docker HEALTHCHECK and load balancers.