Server Infrastructure Setup

Objective: Provision a host and install Docker, Docker Compose, and AWS CLI

Step 1: Confirm Host Sizing

Verify your host meets the minimum specifications:

Spec	Host (Primary Services)
Specs	4 vCPU, 16 GB RAM or larger (≈ t3.xlarge)
OS	Ubuntu 22.04 LTS (or equivalent)
Storage	50 GB+ available disk
Open inbound ports	22, 80, 3000, 4317 (required only if integrating Claude Code), 5432 (Database access, host only; no public or external access permitted)

Note: This is the minimum supported profile for all environment sizes. If you expect high integration or commit volume, contact your Hivel representative before provisioning.

Step 2: Provision the Host

Create a virtual machine or server with the specifications above. Record the private IP address of the host.

Step 3: Install Docker, Docker Compose, AWS CLI, and PostgreSQL

Connect to the host and run the following commands, then verify installation.

# Update system
sudo apt update && sudo apt upgrade -y
sudo apt install -y postgresql postgresql-contrib
sudo apt install -y unzip

# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

# Install Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

# Install AWS CLI (needed only for the registry pull step, see section 4)
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

# Verify installations
docker --version
docker-compose --version
aws --version

# Log out and back in for Docker group changes to take effect

Verify Installation Success:

✓ Each --version command prints a version string with no errors ✓ docker ps runs without requiring sudo

If docker ps still requires sudo after logging back in:

Run newgrp docker to activate the new group membership in your current shell session, or reboot the host if the group change still hasn't taken effect.

Back to Overview

Prerequisites