Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

  1. Create a strong password and click Sign up

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

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

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

  1. 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 page.

GitLab Integration

  1. Click GitLab Connect

  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

  1. 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/

  1. Click Connect

  2. Wait 1–2 minutes for the integration to complete

SonarQube Integration

  1. Click SonarQube Connect

  1. Enter your SonarQube details:

  • SonarQube URL: Your SonarQube instance URL

  • Access Token: Your SonarQube personal access token

  1. Click Connect

  2. Wait 1–2 minutes for the integration to complete

Additional Integrations

For setup instructions on other supported integrations, see the 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 or contact support@hivel.ai.

Next Steps

Review these operational guides to prepare for ongoing management:

Back to Verification and Access

Last updated