Self-Hosting (Experimental)
Experimental guidance for running OpenSana against a self-hosted Convex deployment.
This path is experimental for OpenSana at the time of writing.
OpenSana is designed around Convex. If you want a self-hosted deployment model, the realistic path is to run OpenSana against self-hosted Convex infrastructure rather than trying to remove Convex from the architecture.
Current Position
- self-hosting has not been fully validated for OpenSana end to end
- the app assumes Convex as the backend model
- you should expect extra operational work around deployment, auth, storage, and integrations
Recommended Starting Point
Read the official Convex self-hosting documentation:
What To Validate Yourself
- environment variable compatibility
- auth flows with Clerk
- MCP and CLI connectivity against your chosen hostname and certificates
- file storage and email behavior
- upgrade and migration process
Until this path is tested more thoroughly, treat it as an advanced operator workflow rather than a drop-in supported deployment target.