Basic Requirements for Installing KoboToolbox on AWS

To install and run KoboToolbox on AWS, you will need the following basic resources:

An EC2 instance with at least t3.medium (recommended for stable performance)
80 GB of storage attached to the instance
One Elastic IP address for a fixed public IP
One domain name to access KoboToolbox securely
An AWS Security Group configured to allow the following ports:
- 22 (SSH) for server access
- 80 (HTTP) for web traffic
- 443 (HTTPS) for secure web access

Step 1 — Update Server

sudo apt update && sudo apt upgrade -y

sudo apt install -y git python3-pip curl

 git → needed to download Kobo installer

 python3-pip → needed to install Docker Compose

 curl → needed to download Docker installation script

Step 2 – Install Docker (latest stable)

curl -fsSL https://get.docker.com | sudo sh

 This installs the latest official Docker version, which is recommended.

Step 3 – Check Docker version:

sudo docker –version && docker compose version

Step – 4 – Modify Firewall Settings:

sudo ufw disable

Step 5 – Clone Kobo installer

git clone https://github.com/kobotoolbox/kobo-install.git

Step – 6

Step – 7

cd kobo-install

Run the installer

sudo python3 run.py