# 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F4rxZvNDOQAnYj4Fg4fay%2Fimage.png?alt=media&#x26;token=56f579dd-dfc5-41cb-bbee-f5be95b6ed8f" alt="" width="375"><figcaption></figcaption></figure>
3. **Set a Password**:
   * Create a password for your account and click **"Sign up".**<br>

     <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FwYsdclIjHPC6Xh3XWDW5%2Fimage.png?alt=media&#x26;token=2a49f669-a051-4b44-bd76-8e52f99143ae" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F3jVPegejnzUy3hdWr7WS%2Fimage.png?alt=media&#x26;token=c9524b07-cb89-496e-bdf5-b88654523d76" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FAhrIHBSvvOwQmydeZojm%2Fimage.png?alt=media&#x26;token=9ad147f2-61b3-4fc3-b831-87d75ba6fd13" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FcjG8Ki9lbq043betDS6r%2Fimage.png?alt=media&#x26;token=ec38b0b4-2e96-4f9b-97cc-d3796d8ed7cb" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F9p3piWLhw7F4crPkPSQL%2Fimage.png?alt=media&#x26;token=dd50b1ed-f09d-4ccf-88b2-6790ec9a80f5" alt="" width="375"><figcaption></figcaption></figure>

***

## **GitLab Integration**

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

     <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FOSl8OfiTOdC1u0pKYXpv%2Fimage.png?alt=media&#x26;token=7f9238fd-d485-4bc0-bf1c-79b46b54ac3e" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FkzwiwunaiX0FNrvIBMZF%2Fimage.png?alt=media&#x26;token=fc6a2662-4574-4e2e-9ee1-2889068cca16" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FDli8oScipXJU0N4fUrHB%2Fimage.png?alt=media&#x26;token=4e44050d-554c-4087-b2a6-68322466bde9" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FRuewvZQVpEDWwnAifRhC%2Fimage.png?alt=media&#x26;token=ea9be1b8-fdb4-42b7-acba-c9a0569aee7f" 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.