Hivel On-Premises Deployment Guide (Azure)

Complete step-by-step guide for deploying Hivel services on your Azure infrastructure.

Before you start:

If you prefer to run your own PostgreSQL database instead of Azure Database for PostgreSQL, use the Self-Hosted deployment guide instead. Every other step is identical.

Security note: All credentials, database passwords, and application passwords in this guide are placeholders. Generate your own credentials using openssl rand -base64 24 and store them in Azure Key Vault. Never reuse example credentials in production environments.

Page	Description
Overview	Understand the single-VM + Azure PostgreSQL architecture
Azure Infrastructure Setup and CLI Configuration	Provision a VM and install CLI tools
Prerequisites and Virtual Machine Requirements	Gather accounts, VM, and tools needed
↳ Verify Prerequisites Before Starting	Check Docker, Azure CLI, AWS CLI, and psql versions
↳ Network Requirements	Verify inbound/outbound ports and connections
↳ Virtual Machine Requirements	Confirm VM sizing, OS, and storage specifications
Database Setup	Provision Azure Database for PostgreSQL
Project Setup	Download the installer package from S3
ECR Access Configuration	Configure AWS credentials and log in to ECR registry
Environment Configuration	Create .env file with database credentials
Database Migration	Run Flyway schema migration
Deployment Methods	Choose your deployment method
↳ Method 1: Deployment Using deploy.sh Script	Deploy automatically using deploy.sh
↳ Method 2: Deployment Using Docker Compose	Deploy manually using Docker Compose
Log Rotation Setup	Enable daily log rotation with retention
Verification and Access	Confirm services and UI are running
Application Setup Guide: User Sign-up and Integration	Sign up users, set up your organization, and integrate tools
ADVANCED
Troubleshooting	Resolve common issues
Backup and Restore	Back up and restore the database
Upgrade and Rollback	Upgrade versions or roll back failures
Uninstall and Cleanup	Decommission VM and revoke credentials
Security and Secrets	Store and rotate credentials securely
Quick Reference	View checklist and key deploy.sh commands
Support and Summary	Gather information before contacting support

Back to TL;DR (Azure)

Overview