Deployment
OberonCMS supports Next.js and TanStack Start. Use a host that supports your framework and Node.js 24.21.0 or later. For platform setup, use the framework’s deployment guide:
Prepare the app
- Configure your production database.
- Configure your email service.
- Set the auth variables.
- Set the credentials for your selected plugins.
- Set
USE_DEVELOPMENT_DATABASE=false. - Set
USE_DEVELOPMENT_SEND=false. - Set
BETTER_AUTH_URLto your public HTTPS URL.
The installer enables development features in .env.local. Do not use those settings for production
builds. The build process must use the intended production database.
Build
Run the generated app’s build script:
npm run buildThe app’s prebuild script runs Oberon bootstrap. Bootstrap runs
database migrations and creates initial CMS data. Give the build environment access to the required
database and email settings.
Use your framework’s deployment guide to run the build output. The TanStack recipe’s preview command is for checking a build, not a production hosting guide.
Check the deployment
- Open
/cmson the deployed site. - Sign in with an existing admin email.
- Create a test page.
- Publish the page.
- Open the published page.
- Test image uploads if you configured storage.
Use HTTPS for the public site and editor. Keep database, email, storage, and auth secrets out of browser code. Check host logs if a build or request fails. See Troubleshooting for CMS-specific checks.