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

# Project Setup

#### Overview

The `hivel-onprem` package contains deployment scripts, Docker Compose files, and configuration templates. It does not include licenses or credentials. You add those separately. You'll receive a bucket path or pre-signed URL from Hivel support.

### Step 1: Download the Deployment Package

On the host:

```
cd /opt

# Using AWS CLI
aws s3 cp s3://hivel-on-prem-logs/hivel-agent-onprem-deploy/hivel-onprem.zip ./

unzip hivel-onprem.zip
cd hivel-onprem
chmod +x deploy.sh
```

Verify Download.

**Success:** Output shows `deploy.sh`, `config/`, `license/`, `services/`, and `scripts/` directories\
**Failure: AWS CLI error (Access Denied):** Your AWS credentials have ECR access but not S3 read permission for the installer bucket. Confirm with Hivel support that your credentials cover both ECR and the installer S3 bucket.\
**Failure: curl error:** The pre-signed URL has expired. Request a fresh one from Hivel support.

### Step 2: Add License File

Hivel will provide `license_signed.json`. Copy this file to the `hivel-onprem/license/` directory on the host:

{% code expandable="true" %}

```
# 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/
```

{% endcode %}

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

{% column %}

{% endcolumn %}

{% column %} <a href="/self-managed-hivel-deployment/on-premises-generic/hivel-on-premises-deployment-guide-generic/registry-access-configuration.md" class="button primary" data-icon="forward">Registry Access Configuration</a>
{% endcolumn %}
{% endcolumns %}