> 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/azure/hivel-on-premises-deployment-guide-azure/project-setup.md).

# Project Setup

On-Prem Deployment Guide (Azure)

### **Step 1: Download Project from S3**

**Where to go:** Your VM

**Prerequisites:** AWS CLI configured (or a pre-signed URL from Hivel)

The hivel-onprem package is stored in Hivel's S3 bucket and is distributed this way for all clients regardless of cloud provider. The package contains deployment scripts, Docker Compose files, and configuration templates. It does not contain your license or credentials.

**Run these commands on your VM:**

```
cd /opt
 
# Download the package from S3 
# Using AWS CLI
aws s3 cp s3://hivel-on-prem-logs/hivel-agent-onprem-deploy/hivel-onprem.zip ./
 
# Extract the package
unzip hivel-onprem.zip
cd hivel-onprem
 
# Make deploy script executable
chmod +x deploy.sh
```

**Expected result:** Running `ls` inside the `hivel-onprem` directory shows:

* `deploy.sh`
* `config/`
* `license/`
* `services/`
* `scripts/`

**If download fails:**

* `Access Denied` error: Your configured AWS credentials do not have permission to access the S3 location. Confirm with Hivel which credentials to use, or request a pre-signed URL instead.

**Note:** You will receive the S3 bucket path or pre-signed download URL from Hivel support.

### **Step 2: Add License Files**

**Where to go:** Your VM (in the hivel-onprem directory)

Copy your license files to the license directory:

```
# Copy license files to the license directory
cp license_signed.json hivel-onprem/license/
cp hivel_onprem_public.pem hivel-onprem/license/
 
# Verify files exist
ls -l license/
```

**Expected result:** `ls -l license/` shows:

* `license_signed.json`
* `hivel_onprem_public.pem`

**Next Step:** ECR Access Configuration<br>

{% columns %}
{% column %} <a href="/self-managed-hivel-deployment/virtual-private-cloud/azure/hivel-on-premises-deployment-guide-azure/database-setup.md" class="button primary" data-icon="backward">Back to Database Setup</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/self-managed-hivel-deployment/virtual-private-cloud/azure/hivel-on-premises-deployment-guide-azure/ecr-access-configuration.md" class="button primary" data-icon="forward">ECR Access Configuration</a>
{% endcolumn %}
{% endcolumns %}