On-Prem Setup

Requirements

• Linux server (Ubuntu, Debian, Amazon Linux, RHEL, or Fedora)
• 2GB+ free disk space
• Port 80 open (and 443 if you want SSL later)
• An OpenAI API key

1. Install

Run the bootstrap script to install Docker, Docker Compose, and Python if missing, then download benchmax:

curl -sSL https://raw.githubusercontent.com/rishabhjain30/recordroom-onprem/main/bootstrap.sh | bash

If Docker was just installed, log out and back in for permissions to take effect. Then run the installer:

cd /opt/recordroom && bash scripts/install.sh

You'll be asked for:

• Domain or IP address (default: localhost)
• HTTP port (default: 80)
• Database — built-in Postgres (recommended) or external
• OpenAI API key
• Admin email, password, and name

Once complete, open http://<your-server-ip> in your browser and log in.

2. Set Up Your Data Source

Install the benchmax CLI on your local machine and point it at your server:

npm install -g @recordroom/cli
recordroom config set server http://YOUR-SERVER-IP
recordroom auth login

Then copy the setup guide below and paste it to your coding agent (Claude Code, Cursor, etc.) along with your server URL. The agent will walk you through connecting your database, configuring sync, writing a parser, and setting up quality analysis.

3. Day-to-Day Commands

All commands run from /opt/recordroom:

4. Enable SSL (Optional)

If you have a domain pointed at your server:

bash scripts/enable-ssl.sh yourdomain.com

Gets a free Let's Encrypt certificate, configures HTTPS, sets up auto-renewal, and redirects HTTP to HTTPS.

5. Upgrade

cd /opt/recordroom
bash scripts/upgrade.sh 1.0.4

Backs up your database, pulls new images, runs migrations, and restarts services. Rolls back automatically if the health check fails.

Troubleshooting