Vercel is the recommended deployment path for most users. You get a free PostgreSQL database via the Neon integration, automatic HTTPS, and zero server management.
You need a GitHub organization invite to access the repository. If you haven’t received one, or it has expired, contact me. After accepting, the repository will be available at github.com/domainer-platform/domainer-platform-releases.
1
Fork the repository
Go to github.com/domainer-platform/domainer-platform-releases and click Fork → Create fork.
2
Add your own commit
Vercel’s free Hobby plan requires the deploying project to have at least one commit authored by the account owner. Since the existing commits belong to the platform maintainer, you need to add your own.No terminal needed:
- Open your fork on GitHub
- Click on
README.mdin the file list - Click the pencil icon ✏️ (Edit this file)
- Add a space or any character anywhere
- Click Commit changes → Commit changes again to confirm
3
Import the repository to Vercel
- Go to vercel.com and sign in
- Click Add New → Project
- Find your fork in the repository list → click Import
4
Fill in environment variables
On the project configuration screen, scroll down to Environment Variables and add the following before clicking Deploy:After filling in the variables, click Deploy. The first deploy will fail — this is expected, because the database hasn’t been connected yet. Continue to the next step.
Do not add
POSTGRES_URL — it will be injected automatically by the Neon integration in the next step. If you add it manually, it will conflict.5
Add the Neon database
While the deploy is running (or after it fails), add the database:
- In your Vercel project, go to the Storage tab
- Click Connect Store → select Neon → Continue
- Choose a region closest to your users → Create
6
Add your domain
- In your project, go to Settings → Domains
- Enter your domain name → click Add
- Update your DNS records at your domain registrar with the values Vercel shows
- Wait for the Valid Configuration ✓ status
NEXT_PUBLIC_URL earlier, update it now: Settings → Environment Variables → set it to your real domain (e.g. https://example.com).Now trigger a redeploy: Deployments tab → find the latest deployment → click ⋯ → Redeploy. This single redeploy picks up the Neon database, the correct URL, and your domain all at once.7
Open the Setup Wizard
Visit your domain — you’ll be redirected to the Setup Wizard at
/admin/install. Complete the wizard to seed your database, configure AI, and set up notifications.See Setup Wizard for a full step-by-step walkthrough.Scheduled jobs
Three scheduled jobs are pre-configured invercel.json and run automatically once CRON_SECRET is set — no additional configuration needed:
Updating
When a new version is released, updating on Vercel takes one click:- Open your fork on GitHub
- Click Sync fork → Update branch
- Vercel detects the new commit and deploys automatically
Why does the first deploy fail?
Why does the first deploy fail?
The platform requires a PostgreSQL database to start. On the first deploy, the database hasn’t been connected yet, so the build completes but the app can’t initialize. Once Neon is added and you redeploy, everything starts correctly. This is a one-time issue.
Why does Vercel need my own commit?
Why does Vercel need my own commit?
Vercel’s free Hobby plan restricts deployments of private repositories to projects where the connected account has authored at least one commit. Since all existing commits belong to the platform maintainer, adding a trivial commit to your fork satisfies this requirement.
PLATFORM_URL — do I need to set it?
PLATFORM_URL — do I need to set it?
On Vercel,
NEXT_PUBLIC_URL is baked into the JavaScript bundle at build time, so PLATFORM_URL is not required — the platform falls back to NEXT_PUBLIC_URL automatically. If you ever set up a custom proxy or reverse domain, you can add PLATFORM_URL separately to override the server-side URL without triggering a rebuild.