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.
What you need
Section titled “What you need”-
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.
Secure the server
Section titled “Secure the server”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:
ssh root@your-server-ip # or: ssh ubuntu@your-server-ip on EC2
sudo adduser deploysudo usermod -aG sudo deploysudo mkdir -p /home/deploy/.sshsudo cp ~/.ssh/authorized_keys /home/deploy/.ssh/sudo chown -R deploy:deploy /home/deploy/.sshsudo chmod 700 /home/deploy/.sshsudo chmod 600 /home/deploy/.ssh/authorized_keysTest 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:
sudo systemctl restart sshsudo su - deployOpen the firewall:
sudo ufw allow 22/tcpsudo ufw allow 80/tcpsudo ufw allow 443sudo ufw --force enablePoint your domain at the server
Section titled “Point your domain at the server”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.
Install and run Archon
Section titled “Install and run Archon”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:
curl https://archon.yourdomain.com/api/health