Deployment

Papex can be deployed to Vercel, any Docker environment, or a self-hosted server.

Vercel

1. Import the repo into Vercel.
2. Set env vars: DATABASE_URL, AUTH_SECRET.
3. Build command: npm run build (output handled by Next.js).
4. Bind Postgres via Vercel Storage, or fill an external DATABASE_URL.
5. Run migrations once after deploy: npm run db:migrate.
6. PDF storage: Vercel's filesystem is read-only at runtime, so set STORAGE_DRIVER=s3 and the PAPEX_S3_* variables (see Configuration → Storage). The streaming route then redirects to a presigned object URL instead of serving bytes from disk.

Docker / self-hosted

Use the root docker-compose.yml to run app + database together:

docker compose up -d

Or run only Postgres in Docker and build the Next.js image yourself:

docker build -t papex .
docker run -e DATABASE_URL=... -e AUTH_SECRET=... -p 3000:3000 papex

Docs site

Docs are built with VitePress into public/docs and served by the main app at /docs:

npm run docs:build