> 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/verification-and-access.md).

# Verification and Access

#### Validation Checklist

<table data-search="false"><thead><tr><th>Check</th><th>How to verify</th></tr></thead><tbody><tr><td>Database connectivity</td><td><code>psql -h $DB_HOST -U &#x3C;user> -d insightly</code> connects from host without error</td></tr><tr><td>Cache/queue (Redis)</td><td><code>docker exec -it insightly-redis redis-cli ping</code> returns <code>PONG</code></td></tr><tr><td>API readiness</td><td><code>curl http://localhost:80/health</code> returns healthy response</td></tr><tr><td>UI access</td><td>UI loads at <code>http://&#x3C;host-ip>:3000</code> with no console error</td></tr><tr><td>Integration connectivity</td><td>Connected Jira/GitHub/GitLab shows "connected" status in the UI, (refer to <a href="/integrations.md">Integrations</a> for more info).</td></tr><tr><td>Data flow</td><td>Open relevant dashboard in Hivel UI: records/metrics appear for the connected integration</td></tr></tbody></table>

### Step 1: Verify All Services Are Running

On the host, run:

```
docker ps
./deploy.sh --health
./deploy.sh --health auth-svc
```

### Step 2: Test Service Endpoints

Run these curl commands on the host to verify each service is responding:

```
curl http://localhost:80/health              # API Gateway
curl http://localhost:8095/health            # Auth Service
curl http://localhost:8082/hivelapi/health   # Insightly Service
curl http://localhost:3000                   # UI
```

**Success:** Each endpoint returns a healthy response with no errors

### Step 3: Load the UI

Open a browser and navigate to one of the URLs below (see Step 4 to choose which option):

* If using **Option A:** `http://<host-ip>:3000`
* If using **Option B or C:** Follow those configuration steps first, then access via your configured URL

**Success:** UI loads with no console errors

### Step 4: Access the Application

Choose one of these access methods:

**Option A: Direct Host IP (Quick test, non-production only)**

Use this only for testing. No HTTPS, no load balancing.

* Web UI: `http://<host-ip>:3000`
* API Gateway: `http://<host-ip>`

**Option B: Your Own Load Balancer / Reverse Proxy (Advanced)**

Choose this if you need a load balancer or reverse proxy in front of the host (ports 80, 3000) but prefer not to use Caddy.

**Option C: Caddy for Automatic HTTPS (Recommended for Production)**

Choose this for automatic HTTPS without a separate load balancer. See [HTTPS Setup with Caddy](/self-managed-hivel-deployment/on-premises-generic/hivel-on-premises-deployment-guide-generic/https-setup-with-caddy-optional.md).

### Step 5: Confirm Data Flow

Connect at least one integration (Jira, GitHub, or GitLab) and verify it shows connected status and data in the UI. See [Application Setup Guide: User Sign-up and Integration](https://docs.hivel.ai/self-managed-hivel-deployment/on-premises/application-setup-guide-user-sign-up-and-integration) for step-by-step instructions.

***

#### Installation Complete

Your deployment is complete when all of the following are true:

✓ All containers show `Up` with healthy status\
✓ All service endpoints return healthy responses\
✓ UI loads without console errors\
✓ At least one integration (Jira/GitHub/GitLab) is connected and shows data

***

#### Next Step

Proceed to [Application Setup Guide: User Sign-up and Integration](https://docs.hivel.ai/self-managed-hivel-deployment/on-premises/application-setup-guide-user-sign-up-and-integration) to create your first admin account and connect engineering tools.

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

{% column %} <a href="/self-managed-hivel-deployment/on-premises-generic/hivel-on-premises-deployment-guide-generic/application-setup-guide-user-sign-up-and-integration.md" class="button primary" data-icon="forward">Application Setup Guide</a>
{% endcolumn %}
{% endcolumns %}

[Back to Integrations](/integrations.md)