> 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/application-setup-guide-user-sign-up-and-integration.md).

# Application Setup Guide: User Sign-up and Integration

Create your admin account, set up your organization, and connect engineering tools (GitLab, Jira, SonarQube, etc.)

### Step 1: Access the Sign-up Page in Hivel

In a browser, navigate to:

1. Go to `http://localhost:3000/signup` or `http://<SERVER_IP>/signup`

### Step 2: Create Your Account

1. Enter your email address and click **Continue**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FBU2FOFUHBf6uYJvncVW1%2FScreenshot%202026-09-02%20at%201.52.46%E2%80%AFPM.png?alt=media&amp;token=61b9fbf5-4e48-424e-98c4-2021167151ee" alt=""><figcaption></figcaption></figure>

2. Create a strong password and click **Sign up**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FKtnIUSS89S3KhbeQKqmH%2Fimage.png?alt=media&amp;token=b6970484-49a9-4553-9b9d-b4e98393da5d" alt=""><figcaption></figcaption></figure>

3. Check your email inbox for a verification email and click the verification link to complete sign-up

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FMTcrpWapnD9cyNJxWqjo%2Fimage.png?alt=media&amp;token=4a7ab57b-d633-41d8-b4e1-a8e5b0623905" alt=""><figcaption></figcaption></figure>

### Step 3: Log In

Navigate to the login page and enter your email and password. You will be redirected to the Company Profile Creation page.

### Step 4: Set Up Your Organization

1. Fill in your organization's details and click **Continue**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FyWZ9UfkgaQTtNZrwtxXS%2Fimage.png?alt=media&amp;token=254fb760-1e36-4a46-91c6-ac505dd2ad79" alt=""><figcaption></figcaption></figure>

2. Select an approval method for new users joining your organization and click **Continue**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FCCUEQymfEHbx6NcEyh9q%2Fimage.png?alt=media&amp;token=c7ed68e3-7208-4220-b42b-a6c54a9473e1" alt=""><figcaption></figcaption></figure>

3. You will be directed to the Integration Setup page

### Step 5: Connect Integrations

On **Hivel's** Integration Setup page, you can connect any of the supported integrations. Each integration can be configured independently. For a complete list of supported integrations, see the [Integrations](https://docs.hivel.ai/integrations) page.

#### **GitLab Integration**

1. Click **GitLab Connect**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FxKL96z1sJWK0hmiB8qUQ%2Fimage.png?alt=media&amp;token=c407d755-b3ab-4e45-a1be-900b94170b7e" alt=""><figcaption></figcaption></figure>

1. Enter your GitLab details:
   * **URL:** Your GitLab domain (e.g., `https://yourdomain.com`)
   * **Username:** The name of the access token user
   * **Email:** Email associated with the access token user
   * **Access Token:** Your GitLab personal access token
   * **API Version:** `/api/v4`
2. Click **Connect**
3. Wait 1–2 minutes for the integration to complete
4. Verify in Hivel: Go to **Settings > Repository** to see a progressively updated list of repositories being analyzed

#### **Jira Integration**

1. Click **Jira Connect**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FDli8oScipXJU0N4fUrHB%2Fimage.png?alt=media&amp;token=4e44050d-554c-4087-b2a6-68322466bde9" alt="" width="375"><figcaption></figcaption></figure>

2. Enter your Jira details:

* **URL:** Your Jira URL (Cloud: `https://yourcompany.atlassian.net`)
* **Username:** The name of the access token user
* **Email:** Email associated with the access token user
* **Access Token:** Your Jira personal access token
* **API Version:** `/rest/api/3/`

3. Click **Connect**
4. Wait 1–2 minutes for the integration to complete

#### SonarQube Integration

1. Click **SonarQube Connect**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FRuewvZQVpEDWwnAifRhC%2Fimage.png?alt=media&amp;token=ea9be1b8-fdb4-42b7-acba-c9a0569aee7f" alt="" width="375"><figcaption></figcaption></figure>

2. Enter your SonarQube details:

* **SonarQube URL:** Your SonarQube instance URL
* **Access Token:** Your SonarQube personal access token

3. Click **Connect**
4. Wait 1–2 minutes for the integration to complete

#### Additional Integrations

For setup instructions on other supported integrations, see the [Integrations](https://docs.hivel.ai/integrations) page.

### What to Expect After Setup

The initial data synchronization may take time depending on the volume of historical data. Once all integrations complete:

* Repositories, issues, and metrics appear in their respective dashboards
* You have full access to Hivel's analysis and reporting features
* New data will sync automatically on a regular schedule

#### Troubleshooting

For issues during setup, see [**Troubleshooting**](/self-managed-hivel-deployment/virtual-private-cloud/azure/hivel-on-premises-deployment-guide-azure/troubleshooting.md) or contact <support@hivel.ai>.

#### Next Steps

Review these operational guides to prepare for ongoing management:

* [Backup and Restore](/self-managed-hivel-deployment/virtual-private-cloud/azure/hivel-on-premises-deployment-guide-azure/backup-and-restore.md)
* [Upgrade and Rollback](/self-managed-hivel-deployment/virtual-private-cloud/azure/hivel-on-premises-deployment-guide-azure/upgrade-and-rollback.md)
* [Uninstall and Cleanup](/self-managed-hivel-deployment/virtual-private-cloud/azure/hivel-on-premises-deployment-guide-azure/uninstall-and-cleanup.md)
* [Security and Secrets](/self-managed-hivel-deployment/virtual-private-cloud/azure/hivel-on-premises-deployment-guide-azure/security-and-secrets.md)

{% columns %}
{% column %} <a href="/self-managed-hivel-deployment/virtual-private-cloud/aws/hivel-on-premises-deployment-guide-aws/verification-and-access.md" class="button primary" data-icon="backward">Back to Verification and Access</a>
{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}