> 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/archive/generic/hivel-on-premises-deployment-guide-generic.md).

# Hivel On-Premises Deployment Guide (Generic)

**Hivel On-Premises Deployment Guide**

Complete step-by-step guide for deploying Hivel services on your own infrastructure - AWS, Azure, GCP, or bare-metal / private data center.

**Security note:** any registry credential, database password, or application password shown in this guide is a placeholder. Never reuse an example credential from documentation in a real environment - generate your own and store it in a secrets manager (see Security and Secrets).

This section covers deploying Hivel on your own cloud-agnostic infrastructure - AWS, Azure, GCP, or bare-metal/private data center - from provisioning through configuration, deployment, verification, and ongoing operations. Use the table below to jump directly to any page.

<table data-search="false"><thead><tr><th>Page</th><th>Description</th></tr></thead><tbody><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/1.-overview.md">Overview</a></td><td>What's deployed, the shared component/role table, and which cloud-agnostic vs. AWS/Azure/self-hosted guide to pick.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/2.-prerequisites-and-vm-server-requirements.md"><strong>Prerequisites and VM Server Requirements</strong></a></td><td>Required access/tooling, the consolidated network requirements table, and VM sizing for any cloud.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/3.-infrastructure-setup.md"><strong>Infrastructure Setup</strong></a></td><td>Provisioning the server on any provider and installing Docker, Docker Compose, and AWS CLI.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/4.-aws-cli-configuration-hivel-ecr-access.md"><strong>AWS CLI Configuration (Hivel ECR Access)</strong></a></td><td>Authenticating the server against Hivel's AWS-hosted ECR to pull service images.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/5.-database-and-project-setup.md"><strong>Database and Project Setup</strong></a></td><td>Provisioning PostgreSQL, opening network access, creating "insightly", then downloading the installer package and license files.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/6.-environment-configuration.md"><strong>Environment Configuration</strong></a></td><td>Creating .env and configuring the two-phase (root → app user) database credentials, with password-quoting rules.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/7.-database-migration.md"><strong>Database Migration</strong></a></td><td>Running the one-time Flyway migration on VM to create schemas and the application user.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/8.-deployment-methods.md"><strong>Deployment Methods</strong></a></td><td>Comparison of the two ways to bring services up: the deploy.sh script or Docker Compose directly.</td></tr><tr><td>↳ <a href="/archive/generic/hivel-on-premises-deployment-guide-generic/8.-deployment-methods/method-1-deployment-using-deploy.sh-script-recommended.md">Method 1: Deployment Using deploy.sh Script (Recommended)</a></td><td>Deploying VM services with deploy.sh, plus the full command reference.</td></tr><tr><td>↳ <a href="/archive/generic/hivel-on-premises-deployment-guide-generic/8.-deployment-methods/method-2-using-docker-compose-directly.md">Method 2: Using Docker Compose Directly</a></td><td>Manual ECR login, network creation, and per-server docker-compose deployment steps.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/9.-log-rotation-setup.md"><strong>Log Rotation Setup</strong></a></td><td>Installing the cron job that rotates and prunes container logs daily on the server.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/10.-verification-and-access.md"><strong>Verification and Access</strong></a></td><td>Validation checklist, endpoint tests, and three options (direct IP, load balancer, DNS+load balancer) for accessing the app.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/11.-troubleshooting.md"><strong>Troubleshooting</strong></a></td><td>Symptom → cause → diagnosis → resolution entries for the most common deployment issues.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/12.-backup-and-restore.md"><strong>Backup and Restore</strong></a></td><td>Backing up the "insightly" database (managed snapshots or pg_dump) and the full restore sequence.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/13.-upgrade-and-rollback.md"><strong>Upgrade and Rollback</strong></a></td><td>Steps to upgrade to a new release safely, and how to roll back if validation fails.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/16.-quick-reference.md"><strong>Quick Reference</strong></a></td><td>Full deployment checklist plus service ports and file location tables.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/14.-uninstall-and-cleanup.md"><strong>Uninstall and Cleanup</strong></a></td><td>Full teardown sequence: containers, database, infrastructure resources, and credential revocation.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/15.-security-and-secrets.md"><strong>Security and Secrets</strong></a></td><td>Where each credential comes from, how to store them, and how to self-rotate the application DB password.</td></tr><tr><td><a href="/archive/generic/hivel-on-premises-deployment-guide-generic/17.-support-and-summary.md"><strong>Support and Summary</strong></a></td><td>What to collect before contacting Hivel support, and a summary of the full guide.</td></tr></tbody></table>

{% columns %}
{% column %} <a href="/archive/generic.md" class="button primary" data-icon="backward">Generic</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/archive/generic/hivel-on-premises-deployment-guide-generic/1.-overview.md" class="button primary" data-icon="forward">Overview</a>
{% endcolumn %}
{% endcolumns %}