Self Hosting

Self-Hosting

You can deploy your own instance of Quasar AI on Vercel for free. This gives you full control over your data and backend.

Prerequisites

• A Vercel account (free Hobby plan works)
• A MongoDB Atlas account (free M0 cluster works)
• Node.js 18+ (for local development)

Step 1 — Fork the Repository

Fork github.com/coder11125/QuasarAI to your GitHub account.

Step 2 — Create a MongoDB Database

1. Create a free cluster on MongoDB Atlas
2. Create a database user with read/write permissions
3. Add 0.0.0.0/0 to the IP allowlist (required for Vercel serverless functions)
4. Copy the connection string — it looks like:

   mongodb+srv://username:password@cluster.mongodb.net/quasar?retryWrites=true&w=majority
   

Step 3 — Generate Secrets

Run these commands in your terminal to generate secure values:

# JWT secret
openssl rand -base64 48

# Encryption key (must be exactly 64 hex characters = 32 bytes)
openssl rand -hex 32

Step 4 — Deploy to Vercel

1. Go to vercel.com/new and import your forked repository
2. In the Environment Variables section, add:

Variable	Value
MONGODB_URI	Your MongoDB Atlas connection string
JWT_SECRET	Output of openssl rand -base64 48
ENCRYPTION_KEY	Output of openssl rand -hex 32

3. Click Deploy

Vercel builds and deploys automatically. Your instance is live at your-project.vercel.app.

Local Development

# Clone your fork
git clone https://github.com/YOUR_USERNAME/QuasarAI.git
cd QuasarAI

# Install dependencies
npm install

# Create a .env file with your variables
echo "MONGODB_URI=..." >> .env
echo "JWT_SECRET=..." >> .env
echo "ENCRYPTION_KEY=..." >> .env

# Start local dev server (requires Vercel CLI)
npx vercel dev

Updating

To pull in upstream changes:

git remote add upstream https://github.com/coder11125/QuasarAI.git
git fetch upstream
git merge upstream/main
git push

Vercel redeploys automatically on every push to main.