Find the layer that needs attention.
Start with the service, then authentication, then client registration and memory contents.
The server cannot start
Check the license value for surrounding whitespace or unintended quotes. Confirm that it has not expired. Verify DATABASE_URL, network access, and the pgvector extension. Startup migrations require the database role to have the necessary schema permissions. If port 8080 is occupied, review the bind setting or Compose port mapping.
The client cannot connect
Confirm the endpoint and active mode, then test the remote connection. Clients need a developer API token; the commercial license is not a client credential. Check that your reverse proxy permits the MCP route and that the token is valid.
palace remote status
palace remote test
palace doctorThe agent does not see Palace tools
Run palace install, then fully restart the coding client. For Codex CLI hooks, also trust them once through /hooks.
Search returns nothing useful
Check Palace status, the intended project wing, and whether relevant memories have been filed. A successful connection does not populate a project automatically. Ask the agent to inspect the project state before requesting repository mining. Use a concrete decision or convention in the first test.