Deployment guide

Deploy Nona on AWS

The simplest AWS deployment for Nona is an Ubuntu EC2 instance with Docker and the instance's EBS-backed storage.

Recommended AWS shape

  • Use Amazon EC2 as the starting point.
  • Pick a region close to your team or initial users.
  • Choose Ubuntu if you want to use the commands in this guide as-is.
  • Use the instance root EBS volume to start, then add a larger EBS disk later if needed.

AWS steps

  1. Launch a new EC2 instance in the AWS console.
  2. Select an Ubuntu image and a suitable instance type.
  3. Create or choose an SSH key pair.
  4. Set the security group to allow inbound ports 22 and 18080 for the initial smoke test.
  5. Connect to the instance over SSH.

Official EC2 getting-started guide: Launch and connect to an EC2 instance

Install Docker and run Nona

1. Install Docker

sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl enable --now docker

2. Run Nona

sudo docker run -d \
  --name nona \
  --restart unless-stopped \
  -p 18080:8080 \
  -v nona-data:/var/lib/nona \
  rywaredev/nona:latest

Optional: use a dedicated EBS volume

If you attach and mount a separate EBS volume, bind that mount into /var/lib/nona.

sudo mkdir -p /mnt/nona

sudo docker run -d \
  --name nona \
  --restart unless-stopped \
  -p 18080:8080 \
  -v /mnt/nona:/var/lib/nona \
  rywaredev/nona:latest

After the AWS deployment works

  • Put TLS in front of the instance before using it seriously.
  • Back up the EBS-backed storage path.
  • Lock down the security group once the smoke test is complete.

Need the overview? Go back to the deploy hub.