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

# Application Setup Guide: User Sign-up and Integration

Follow this step-by-step guide to sign up, set up your organization, and integrate essential tools like GitLab, Jira, and SonarQube to get your application up and running.

## **User Sign-up**

1. **Navigate to the Signup Page**:
   * Go to <http://localhost:3000/signup> or http\://\<SERVER\_IP>/signup.
2. **Create Your Account**:
   * Enter your email address and click Continue.<br>

     <figure><img src="/files/tcpTlDW4TqiYVdLhvlSf" alt="" width="375"><figcaption></figcaption></figure>
3. **Set a Password**:
   * Create a password for your account and click **"Sign up".**<br>

     <figure><img src="/files/M8D8OkrYnQggzFW3dbeE" alt="" width="375"><figcaption></figcaption></figure>
4. **Complete Sign Up**:
   * Once the sign up is complete, a message will prompt you to go to the login page. Click on **"Back to Login".**<br>

     <figure><img src="/files/dTRQ4jh0Vj4d0F7rXQI0" alt="" width="375"><figcaption></figcaption></figure>

***

## **User Login**

1. **Login Page**:
   * Navigate to the login page.
2. **Enter Credentials**:
   * Enter your signed up email and password from the previous steps.
3. **Company Profile Setup**:
   * After successful login, you'll be redirected to the **Company Profile Creation** page for the first user.<br>

     <figure><img src="/files/0KQbeDEe5a55Pl8jq6PK" alt="" width="375"><figcaption></figcaption></figure>

***

## **Organization Setup**

1. **Enter Organization Details**:
   * Fill in your organization’s details in the required fields.
   * Click **Continue**.
2. **Complete Organization Creation**:
   * On the next page, click **Continue** again.<br>

     <figure><img src="/files/g3UfvvFV0tYJAxYFpZhm" alt="" width="375"><figcaption></figcaption></figure>
3. **Redirection to Integration Page**:
   * After the organization setup, you will be directed to the **Integration Page**.<br>

     <figure><img src="/files/30x5ST2GTOsgljCq0Yhp" alt="" width="375"><figcaption></figcaption></figure>

***

## **GitLab Integration**

1. **Start Integration**:
   * On the integration page, click the **GitLab Connect** button.<br>

     <figure><img src="/files/QY5QG749v0N1LSsfZGmo" alt="" width="375"><figcaption></figcaption></figure>
2. **Enter GitLab Details**:
   * **URL**: Enter your GitLab domain URL (e.g. `https://yourdomain.com`).
   * **Username**: The name of the access token user.
   * **Email**: The email associated with the access token user.
   * **Access Token**: Your GitLab access token.
   * **API Version**: `/api/v4`.
3. **Complete Integration**:
   * After entering the details, wait for about one minute for the integration to complete.
4. **Verify Repositories**:
   * Navigate to **Settings > Repository** screen
   * The Repositories page shows a progressively updated list of repositories being analyzed by Hivel.

     <br>

     <figure><img src="/files/aVtYNJQ9HobzMJreyAFy" alt="" width="107"><figcaption></figcaption></figure>

***

## **Jira Integration**

1. **Start Integration**:
   * On the integration page, click the **Jira Connect** button.
2. **Enter Jira Details**:
   * **URL**: Your Jira URL (For cloud version: `https://yourcompany.atlassian.net`).
   * **Username**: The name of the access token user.
   * **Email**: The email associated with the access token user.
   * **Access Token**: The Jira access token you created.
   * **API Version**: `/rest/api/3/`.<br>

     <figure><img src="/files/WckGXB8z5iSI4JtnJPm8" alt="" width="375"><figcaption></figcaption></figure>

***

## **SonarQube Integration**

1. **Enter SonarQube Details**:
   * **SonarQube URL**: The URL for your SonarQube instance.
   * **Access Token**: Your SonarQube access token.<br>

     <figure><img src="/files/2zWZugXaDmh0xICnmv2l" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
**Important:** The initial data pull may take time depending on the volume of historical data being synchronized
{% endhint %}

Once all integrations are set up, you should be ready to leverage the full functionality of Hivel. If you encounter any issues, please feel free to contact [<mark style="color:purple;">support@hivel.ai</mark>](mailto:support@hivel.ai) for further assistance.