Deploy to Vercel
Deploy your CamelMind documentation site to Vercel in minutes.
Vercel makes it easy to deploy your CamelMind documentation site. It automatically builds and deploys your site on every Git push, provides HTTPS out of the box, and creates preview deployments for pull requests.
You'll need:
- A CamelMind documentation project
- A GitHub repository containing your project
- A Vercel account
Deploy your CamelMind site to Vercel
Follow these steps to build, configure, and deploy your CamelMind site to Vercel:
Push your project to GitHub
Commit your project and push it to a GitHub repository.
git add .
git commit -m "Initial commit"
git push
If you haven't created a repository yet, create one on GitHub first, then push your project.
Import the repository into Vercel
- Sign in to Vercel.
- Select Add New → Project.
- Choose your GitHub repository.
- Click Import.
CamelMind is built on Next.js, so Vercel automatically detects the project and configures the build settings.
Configure environment variables
Before deploying, configure your project's environment variables.
| Variable | Description |
|---|---|
CAMELMIND_URL | The public URL of your documentation site. |
SESSION_SECRET | Required when authentication is enabled. |
If you're using OpenID Connect (OIDC), also configure:
OIDC_ISSUEROIDC_CLIENT_IDOIDC_CLIENT_SECRET
See Environment Variables for the complete list of supported variables.
Deploy
Click Deploy.
Vercel builds and publishes your documentation site. Once deployment completes, your site is available at its public URL.
Every future push to your default branch automatically triggers a new deployment.
Use a custom domain on Vercel
To set up a custom domain for your Vercel deployment, follow these steps:
- Open your Vercel project.
- Go to Settings → Domains.
- Add your domain and follow the DNS instructions.
- Update
CAMELMIND_URLto match your new HTTPS URL.
Preview deployments for pull requests on Vercel
When you create or update a pull request, Vercel automatically builds and assigns a unique preview deployment URL to test your CamelMind changes.
Troubleshooting Vercel deployments
If you encounter issues when deploying your site to Vercel, refer to these common troubleshooting solutions:
The build fails
Verify that all project dependencies are committed to your repository.
If you've recently installed new packages:
npm install
git add package.json package-lock.json
git commit -m "Update dependencies"
git push
Authentication redirects to the wrong URL
Verify that CAMELMIND_URL exactly matches your site's public HTTPS URL, without a trailing slash.