> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws.md).

# 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.

{% hint style="warning" %}
**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**](https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/security-and-secrets) for details.
{% endhint %}

**Alternative:** If you prefer self-managed PostgreSQL instead of RDS, use the [**Self-Hosted Deployment Guide**](https://docs.hivel.ai/self-managed-hivel-deployment/on-premises) instead. All other steps are identical.

<table data-search="false"><thead><tr><th>Page</th><th>Description</th></tr></thead><tbody><tr><td><strong>Getting Started</strong></td><td></td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/aws-infrastructure-setup-and-aws-cli-configuration"><strong>AWS Infrastructure Setup</strong></a></td><td>Provision EC2, install Docker and CLI tools, configure AWS credentials.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/prerequisites-overview"><strong>Prerequisites and Architecture</strong></a>  </td><td>Understand the EC2 + RDS setup and make key deployment decisions.</td></tr><tr><td>↳ <a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/prerequisites-overview/deployment-decision-guide-what-you-need-before-starting.md">Deployment Decision Guide, What You Need Before Starting</a> </td><td><strong>Make three decisions:</strong> container registry (ECR), deployment method, and public access configuration. Complete the pre-deployment checklist.</td></tr><tr><td>↳ <a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/prerequisites-overview/verify-prerequisites-before-starting-network-requirements.md">Verify Prerequisites Before Starting, Network Requirements</a></td><td>Check versions and review inbound/outbound network requirements.</td></tr><tr><td>↳ <a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/prerequisites-overview/verify-ec2-instance-requirements-resource-sizing.md">EC2 Instance Requirements (Resource Sizing)</a></td><td>Verify VM size, operating system, storage, and required ports.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/rds-database-setup"><strong>RDS Database Setup</strong></a></td><td>Create and secure the PostgreSQL database.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/project-setup-and-environment-configuration"><strong>Project Setup</strong></a></td><td>Download installer, configure environment variables.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/ecr-access-configuration"><strong>ECR Access Configuration</strong></a> </td><td>Authenticate Docker to pull Hivel images.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/database-migration"><strong>Database Migration</strong></a></td><td>Run Flyway migration to initialize schemas.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/deployment-methods"><strong>Deployment Methods</strong></a></td><td>Deploy services using deploy.sh (recommended) or Docker Compose.</td></tr><tr><td>↳ <a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/deployment-methods/method-1-using-deploy.sh-script-recommended.md">Method 1: Using deploy.sh Script (Recommended)</a></td><td>Deploy services with deploy.sh. Includes full command reference.</td></tr><tr><td>↳ <a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/deployment-methods/method-2-deployment-using-docker-compose.md">Method 2: Deployment Using Docker Compose</a></td><td>Deploy manually: authenticate ECR, create network, and run docker-compose.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/log-rotation-setup"><strong>Log Rotation</strong></a></td><td>Set up automated log rotation.</td></tr><tr><td><a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/verification-and-access.md"><strong>Verification and Access</strong></a></td><td>Validation checklist, endpoint tests, and the three options (direct IP, ALB, Route53+ALB) for accessing the app.</td></tr><tr><td><a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/application-setup-guide-user-sign-up-and-integration.md"><strong>Application Setup Guide: User Sign-up and Integration</strong></a></td><td>Guide to sign up, set up organization, and integrate essential tools.</td></tr><tr><td><strong>ADVANCED</strong></td><td></td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/troubleshooting"><strong>Troubleshooting</strong></a></td><td>Solutions to common deployment issues.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/backup-and-restore"><strong>Backup and Restore</strong></a></td><td>Configure RDS backups and restore procedures.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/upgrade-and-rollback"><strong>Upgrade and Rollback</strong></a></td><td>Upgrade to new releases safely.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/uninstall-and-cleanup"><strong>Uninstall and Cleanup</strong></a></td><td>Full teardown sequence.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/security-and-secrets"><strong>Security and Secrets</strong></a></td><td>Credential management and rotation.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/quick-reference"><strong>Quick Reference</strong></a> </td><td>Deployment checklist and file locations.</td></tr><tr><td><a href="https://docs.hivel.ai/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/support-and-summary"><strong>Support</strong></a></td><td>What to gather before contacting Hivel support.</td></tr></tbody></table>

{% columns %}
{% column %} <a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/tl-dr-aws.md" class="button primary" data-icon="backward">Back to TL;DR (AWS)</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/aws-infrastructure-setup-and-aws-cli-configuration.md" class="button primary" data-icon="forward">AWS Infrastructure Setup</a>
{% endcolumn %}
{% endcolumns %}