Method 1: Using deploy.sh Script (Recommended)

On-prem Deployment Guide (AWS)

Goal: Deploy all Hivel VM services using an automated script.

Prerequisites:

• Database Migration completed successfully

• .env file configured with application user credentials (DB_USER and DB_PASSWORD)

• Docker and Docker Compose installed on VM

• AWS ECR access configured (IAM role or AWS CLI credentials)

Deploy All Services

Application/System: EC2 VM (Docker)

On your EC2 VM, run:

cd /opt/hivel-onprem

# Deploy all VM services
./deploy.sh --vm

(OR)

Deploy Specific Services

If you need to deploy only certain services instead of all:

contact Hivel [e-mail] for more info on deploying a specific service and list of services.

Available deploy.sh Commands

# Deploy all services (VM on same instance)
./deploy.sh --all

# Deploy VM services 
./deploy.sh --vm

# Deploy specific service
./deploy.sh --service <service-name>

# Check service status
./deploy.sh --status

# Check service health
./deploy.sh --health

# View logs
./deploy.sh --logs
./deploy.sh --logs <service-name>

# Start services
./deploy.sh --start

# Stop services
./deploy.sh --stop

# Restart services
./deploy.sh --restart

# Update services (pull latest images)
./deploy.sh --update

# List all services
./deploy.sh --list

# Show help
./deploy.sh --help

Troubleshooting

• Services fail to start: Check .env file has correct database credentials and RDS is reachable

• Image pull fails: Verify AWS ECR credentials and access

• Health checks fail: Review logs with ./deploy.sh --logs <service-name>

See Troubleshooting for detailed solutions.

Deployment Methods

Method 2: Docker Compose