Vercel Deployment

Serverless hosting with zero configuration

Vercel is the platform built by the creators of Next.js. Deploy ATStatus in minutes with automatic SSL, global CDN, and seamless Git integration.

Database Required: SQLite doesn't work on Vercel due to ephemeral filesystem. You must use PostgreSQL (Vercel Postgres, Supabase, Neon) or MySQL (PlanetScale).

Why Vercel?

Zero Configuration

Deploy with one click - Vercel auto-detects Next.js settings

Global CDN

Your status page is served from edge locations worldwide

Free SSL

Automatic HTTPS with Let's Encrypt certificates

Auto Scaling

Handles traffic spikes automatically during incidents

Quick Deploy

Click the Deploy button in the repository README for instant deployment. You'll be guided through environment variable setup automatically.

Go to Vercel Dashboard →

Manual Setup Steps

Fork Repository

Fork the ATStatus repository to your GitHub account

Import to Vercel

Go to vercel.com/new and import your forked repo

Configure Environment

Add required environment variables in project settings

Connect Database

Set up Vercel Postgres or an external database provider

Deploy

Click deploy and wait for your status page to go live

Required Environment Variables

Add these in your Vercel project settings under Environment Variables:

DATABASE_URL - PostgreSQL connection string (required)

SESSION_SECRET - Min 32 characters for session encryption

CRON_SECRET - Secret for authenticated cron endpoints

ADMIN_PASSWORD - Initial admin password for setup

DATABASE_URL=postgresql://user:pass@host:5432/dbname
SESSION_SECRET=your-secret-minimum-32-characters-long
CRON_SECRET=your-cron-secret-for-api-authentication
ADMIN_PASSWORD=your-secure-admin-password

Database Options

Choose a database provider that works with Vercel's serverless architecture:

Vercel Postgres

Native integration with automatic connection string

PlanetScale

Serverless MySQL with branching and auto-scaling

Supabase

Open-source PostgreSQL with real-time features

Neon

Serverless PostgreSQL with branching support

Vercel Postgres (Recommended)

Go to your Vercel project → Storage tab
Click Create Database → Postgres
Select a region close to your users
The DATABASE_URL is automatically added to your project

Vercel Postgres automatically injects the connection string. You don't need to manually configure DATABASE_URL if you use this option.

Custom Domain

Go to your project → Domains tab
Enter your domain (e.g., status.example.com)
Add a CNAME record pointing to cname.vercel-dns.com
SSL is automatically configured by Vercel

# DNS Configuration
Type: CNAME
Name: status
Value: cname.vercel-dns.com
TTL: 3600 (or Auto)

Troubleshooting

Build Fails

Ensure all required environment variables are set
Verify DATABASE_URL is a valid PostgreSQL connection string
Check build logs for specific error messages

Authentication Not Working

Ensure SESSION_SECRET is at least 32 characters
Verify CRON_SECRET is set for API endpoints
Check that ADMIN_PASSWORD is configured

Database Connection Errors

Do NOT use SQLite - it won't persist on Vercel
Ensure your database allows connections from Vercel IPs
Check connection string format matches your provider

Need Help?

Build Failures

Check all environment variables are set correctly

Database Setup

Detailed database configuration guide

Environment Variables

Complete list of all configuration options