Skip to content

Cloud Deployment

This page prepares a VPS: a user, SSH, a firewall and DNS. The Docker guide then installs and runs Archon on it with Docker Compose and Caddy for HTTPS. Using your own proxy instead of Caddy? See Running Archon behind your own reverse proxy.

For the fastest route, use the cloud-init script instead. It creates a user, opens the firewall and installs Docker when the VPS first boots. You still create the DNS record.

  • A VPS from any provider (DigitalOcean, Linode, AWS EC2, Vultr and so on): 1 to 2 vCPUs, 2 GB RAM minimum (4 GB recommended), 20 GB SSD, Ubuntu 22.04 LTS.

  • A domain or subdomain, such as archon.yourdomain.com.

  • An SSH key. Create one before the VPS, and add the public key when you create it:

    Terminal window
    ssh-keygen -t ed25519 -C "archon"
    cat ~/.ssh/id_ed25519.pub

When you create the VPS, choose the Ubuntu 22.04 image and your SSH key, and allow inbound SSH (22), HTTP (80) and HTTPS (443) if the provider has its own firewall or security group. Note the public IP.

Connect with the image’s default account: root on most VPS providers, ubuntu on AWS EC2, which disables root login. Create a deploy user with your key, and switch to it:

Terminal window
ssh root@your-server-ip # or: ssh ubuntu@your-server-ip on EC2
sudo adduser deploy
sudo usermod -aG sudo deploy
sudo mkdir -p /home/deploy/.ssh
sudo cp ~/.ssh/authorized_keys /home/deploy/.ssh/
sudo chown -R deploy:deploy /home/deploy/.ssh
sudo chmod 700 /home/deploy/.ssh
sudo chmod 600 /home/deploy/.ssh/authorized_keys

Test ssh deploy@your-server-ip in a second terminal before you go on. Then turn off password logins by setting PasswordAuthentication no in /etc/ssh/sshd_config, and restart SSH:

Terminal window
sudo systemctl restart ssh
sudo su - deploy

Open the firewall:

Terminal window
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443
sudo ufw --force enable

At your DNS provider, create an A record: name archon (or @ for the root domain), value the server’s public IP. With Cloudflare, set the record to DNS only, not proxied, so Caddy can obtain its certificate. Check it with dig archon.yourdomain.com.

Follow the Docker guide’s manual server setup. It installs Docker, clones the repository, sets up .env and the Caddyfile, and starts the stack. Before you expose the Web UI, choose a login in Protect the Web UI.

Check the deployment from your machine:

Terminal window
curl https://archon.yourdomain.com/api/health