Installation & Setup

SSH into your instance:

ssh -i <your-key.pem> ubuntu@<EC2-PUBLIC-IP>

Update packages and install tools:

sudo apt update
sudo apt install net-tools certbot -y

Create working directory and clone the deployment repo:

mkdir openwifi-sdk
cd openwifi-sdk
git clone https://github.com/routerarchitects/ra_wlan-cloud-ucentral-deploy.git
cd ra_wlan-cloud-ucentral-deploy/docker-compose

Note: Remove port 80 from docker-compose.yml, as it is required by Certbot during certificate renewal.

Configure S3 Bucket in owfms.env

Edit owfms.env and update these values:

S3_BUCKETNAME=<S3_BUCKETNAME>
S3_REGION=<S3_REGION>
S3_SECRET=<S3_SECRET>
S3_KEY=<S3_KEY>
S3_BUCKET_URI=<S3_BUCKET_URI>
FIRMWAREDB_MAXAGE=3650

Update docker-compose.yml images and matching .env files

In docker-compose.yml, replace image: "docker.io/bitnami/kafka:${KAFKA_TAG}" with image: "docker.io/bitnamilegacy/kafka:${KAFKA_TAG}" in both the kafka and init-kafka services.

If you are using custom-built images (or different tags), replace the image names/tags in docker-compose.yml, then review each service's referenced .env file to ensure required variables and paths match your deployment.

Docker & Docker Compose

Install Docker and Docker Compose:

sudo apt install docker.io docker-compose -y
sudo usermod -aG docker $USER
newgrp docker
sudo chown -R $USER:$USER .