# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hivel.ai/integrations/on-prem-setup/application-setup-guide-user-sign-up-and-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.