Hivel On-Premises Deployment Guide (AWS)
Deploy Hivel on your AWS infrastructure using EC2 for compute and RDS for PostgreSQL. This guide covers provisioning, configuration, deployment, and ongoing operations.
Important
All credentials shown in this guide are placeholders. Never reuse example credentials in a real environment. Generate your own and store them in a secrets manager. See Security and Secrets for details.
Alternative: If you prefer self-managed PostgreSQL instead of RDS, use the Self-Hosted Deployment Guide instead. All other steps are identical.
Getting Started
Provision EC2, install Docker and CLI tools, configure AWS credentials.
Understand the EC2 + RDS setup and make key deployment decisions.
Make three decisions: container registry (ECR), deployment method, and public access configuration. Complete the pre-deployment checklist.
Check versions and review inbound/outbound network requirements.
Verify VM size, operating system, storage, and required ports.
Create and secure the PostgreSQL database.
Download installer, configure environment variables.
Authenticate Docker to pull Hivel images.
Run Flyway migration to initialize schemas.
Deploy services using deploy.sh (recommended) or Docker Compose.
Deploy services with deploy.sh. Includes full command reference.
Deploy manually: authenticate ECR, create network, and run docker-compose.
Set up automated log rotation.
Validation checklist, endpoint tests, and the three options (direct IP, ALB, Route53+ALB) for accessing the app.
Guide to sign up, set up organization, and integrate essential tools.
ADVANCED
Solutions to common deployment issues.
Configure RDS backups and restore procedures.
Upgrade to new releases safely.
Full teardown sequence.
Credential management and rotation.
Deployment checklist and file locations.
What to gather before contacting Hivel support.
Last updated