Installation

Install on a VPS

Run as root on a fresh Ubuntu 20.04 / 22.04 / 24.04 or Debian 11 / 12 server. Upload the ChatDock files to a directory, then run the installer from it.

cd /srv/chatdock
sudo bash install.sh

The installer will:

  1. Install Node.js 22, MongoDB 7, Redis and PM2
  2. Run npm install across all workspaces
  3. Prompt for your domain, SMTP details and AI API keys
  4. Generate secure JWT secrets
  5. Build the API, the web app and the admin console
  6. Start everything under PM2, so it survives a reboot
  7. Optionally configure nginx and a free Let’s Encrypt certificate

When it finishes, open /auth/register on your domain and create the first account.