Skip to content

deployment.md

Latest commit

 

History

History
82 lines (55 loc) · 2.18 KB

deployment.md

File metadata and controls

82 lines (55 loc) · 2.18 KB

Free-First Deployment

PipHackLup is designed to start on free tiers and move to paid hosting later without a rewrite.

Public links:

Dashboard: Vercel Hobby

Deploy apps/web as the Vercel project root.

Environment variables:

  • DATABASE_URL
  • NEXTAUTH_URL
  • NEXTAUTH_SECRET
  • DISCORD_CLIENT_ID
  • DISCORD_CLIENT_SECRET

The /training page uses Discord OAuth to show the connected organizer account and the servers they can manage. With DATABASE_URL configured, website training and /train slash-command training share the same Postgres-backed Q&A entries and escalation settings. Without DATABASE_URL, the trainer stays in preview mode.

Database: Neon Free

Create a Neon Postgres database and copy the pooled connection string into DATABASE_URL.

Generate migrations locally:

pnpm --filter @piphacklup/db db:generate

Apply migrations:

pnpm --filter @piphacklup/db db:migrate

Bot: Oracle Cloud Always Free

Use an Ampere A1 Always Free VM for the bot process. Install Docker or Node 24 with Corepack.

Basic Node path:

git clone https://github.com/rupayon123/PipHackLup.git
cd PipHackLup
corepack enable
pnpm install --frozen-lockfile
pnpm build
pnpm --filter @piphacklup/bot start

Recommended process manager:

npm install -g pm2
pm2 start "pnpm --filter @piphacklup/bot start" --name piphacklup
pm2 save

Required bot env:

  • DISCORD_TOKEN
  • DISCORD_CLIENT_ID
  • DATABASE_URL
  • PORT=8787
  • PIPHACKLUP_AMBIENT_QA_ENABLED=false

Keep ambient Q&A disabled unless you have enabled the Discord Message Content intent and want the bot to answer when mentioned in normal chat messages. Slash-command Q&A through /ask works without Message Content intent.

Health check:

curl http://localhost:8787/health

Repo creation note

The public repository is live at rupayon123/PipHackLup. Keep the repo public, MIT licensed, and linked to https://piphacklup.vercel.app for discovery.