Pick the right path
Local-first still uses hosted Memory Crystal auth/license. External self-hosting may require additional environment variables and deployment setup.
Public boundary
Public docs should explain supported deployment behavior without exposing hosted SaaS-only internals such as billing, admin, private dashboard code, or internal planning docs.Source material
The strongest public sources are:mcp-server/README.mdapps/docs/self-hosting/railway.mdx.env.examplescripts/convex-local-up.shscripts/convex-local-doctor.sh
Common mistakes
- treating local-first as accountless/offline licensing
- mixing private SaaS architecture with public self-hosting guidance
- documenting the root web app deployment as if it were the MCP deployment path
- linking public users to internal contributor docs instead of the public local-first guide