DevDynamics
  • Overview
    • 💡Getting Started
    • ❓FAQ
    • Configuration
      • Best Practices
      • Setting Up Issue Management System in DevDynamics
      • Setting Up Version Control
      • Setting Up Investment Categories in DevDynamics
      • Configuring Communication Channels in DevDynamics
      • Change Failure
      • Deployment
      • Manage Contributors
      • Manage Teams
  • Integrations
    • GitLab
    • GitHub
    • BitBucket
    • On-Premises BitBucket
    • On-Premises GitHub
    • Jira
    • Slack
    • Linear
    • Pagerduty
    • Microsoft Teams
    • Sonar Cloud
    • Sonar Qube
    • CI/CD
    • Azure Repo
    • Azure Board
    • Opsgenie
    • ClickUp
    • Outlook
    • Google Calendar
    • Shortcut
    • OpenProject
    • Asana
    • Test Suite
  • Installations
    • On-Premises Agent Installation Guide
  • Features
    • Metrics
      • Cycle Time Metrics
      • DORA Metrics
      • Git Dashboard
        • Feedback Responsiveness Index (FRI)
        • Review Responsiveness Index (RRI)
        • Review Completion Index (RCI)
        • Reviewer Distribution
        • Average Active Days
        • PR Review Health
        • Open PR Age
        • Work Breakdown: Distribution of Work (Lines of Code)
      • Ticket Dashboard
        • Issue Throughput
        • Open Issue Age
        • Backward Momentum
        • Issue Cycle Time Spread
        • Requirement Stability Index
      • Issue Closed Count/Task Velocity
      • Story Points Completed
      • Bug Closed Count
      • Bug Opened Count
      • Pull Request Merged Count
      • PR Comment Count
      • Pull Request Size
      • Pull Request Open Count
      • Pull Request Review Count
      • Contributors Working on Non-Working Days
      • Contributors working out of office hours
      • Contributors getting burnout
    • Team Insights
    • Initiatives
Powered by GitBook
On this page
  • System Requirements
  • Prerequisites
  • Installation Steps
  • 1. Create Workspace Directory
  • 2. Download Installation Files
  • 3. Update System and Install Tools
  • 4. Extract Installation Files
  • 5. Configure Agent Configuration File
  • 6. Run Installation Script
  • 7. Check the DevDynamics Daemon Service
  • Configuration Notes
  • Support
  1. Installations

On-Premises Agent Installation Guide

System Requirements

  • Operating System: Ubuntu (Debian-based)

  • Ubuntu Version: 18+ LTS

  • Recommended RAM: 2GB

Prerequisites

Before beginning the installation, ensure you have:

  • Access to a terminal with sudo privileges

  • Bitbucket, GitHub, Jenkins, and SonarQube credentials (if applicable)

  • The server's IP address, where the agent will be running, must be whitelisted in Bitbucket/Github/SonarQube Cloud/Server.

Installation Steps

1. Create Workspace Directory

cd ~

mkdir devdynamics-agent

cd devdynamics-agent

2. Download Installation Files

Clone the stormtrooper in the devdynamics-agent directory.

git clone https://frodo-repo@github.com/devdynamics-ai/stormtrooper.git

Contact the DevDynamics team to get the Personal Access token necessary to autheticate the clone request.

3. Update System and Install Tools

sudo apt update

sudo apt install unzip

4. Extract Installation Files

unzip stormtrooper.zip

cd stormtrooper

5. Configure Agent Configuration File

Edit the dd-agent.conf file with the following sections:

Common Configuration

# Common Configuration

CRON_EXPRESSION='0 * * * *' # Runs every hour by default

ORG_CODE='ABCDEF' # Provided Organization Code

REQUEST_SIZE_THRESHOLD_IN_BYTES='200_000' # DO NOT CHANGE

DD_API_KEY='<dd-api-key>' # DO NOT CHANGE
  • CRON_EXPRESSION: Controls the execution frequency. By default, it runs every hour.

  • REQUEST_SIZE_THRESHOLD_IN_BYTES: Do not modify this value.

GitHub Configuration

# Github Configuration

GITHUB_ENABLED=true

GITHUB_URL='https://api.github.com' # Replace with your Github URL if different (without port)

GITHUB_PORT='443' # Replace with your port if not default (443)

GITHUB_API_TOKENS='<GITHUB_API1>,<GITHUB_API2>'... # Replace with your Github API tokens

GITHUB_ORG_NAME='<GITHUB_ORG_NAME>' # Replace with your Github Organization name
  • GITHUB_ENABLED: This must remain true.

  • GITHUB_URL: The base URL for your GitHub application (exclude the port number).

  • GITHUB_PORT: Specify the port (default is 443).

  • GITHUB_API_TOKENS: Add the API token for your GitHub account. We recommend providing at least 3 API tokens to avoid the rate-limiting condition.

  • GITHUB_ORG_NAME: Add your GitHub Organisation's name.

Bitbucket Configuration

# Bitbucket Configuration

BITBUCKET_ENABLED=true

BITBUCKET_URL='http://X.X.X.X' # Replace with your Bitbucket URL (without port)

BITBUCKET_PORT='80' # Replace with your port if not default (80)

BITBUCKET_API_KEY='<API_KEY>' # Replace with your Bitbucket API Key

BITBUCKET_USER='<USER_NAME>' # Replace with your Bitbucket username
  • BITBUCKET_ENABLED: This must remain true.

  • BITBUCKET_URL: The base URL for your Bitbucket application (exclude the port number).

  • BITBUCKET_PORT: Specify the port (default is 80).

  • BITBUCKET_API_KEY: Add the API token for your Bitbucket account.

  • BITBUCKET_USER: Add your Bitbucket username.

Bitbucket Cloud Configuration

# Bitbucket Cloud configuration

BITBUCKET_CLOUD_ENABLED='true'

BITBUCKET_CLOUD_API_TOKEN=<API_KEY>' # Replace with your Bitbucket API Token

BITBUCKET_CLOUD_USER='<USER_NAME>' # Replace with your Bitbucket username

BITBUCKET_CLOUD_WORKSPACE='<USER_NAME>' # Replace with your Bitbucket workspace
  • BITBUCKET_ENABLED : This must remain true.

  • BITBUCKET_CLOUD_API_TOKEN : Add the API token for your Bitbucket account.

  • BITBUCKET_CLOUD_USER: Add your Bitbucket username.

  • BITBUCKET_CLOUD_WORKSPACE: Add the Bitbucket workspace

Jenkins Configuration

# Jenkins Configuration

JENKINS_ENABLED=true

JENKINS_URL='http://X.X.X.X' # Replace with your Jenkins URL (without port)

JENKINS_PORT='8765' # Replace with your port if not default (8765)

JENKINS_API_TOKEN='<API_TOKEN>' # Replace with your Jenkins API Key

JENKINS_USERNAME='<USER_NAME>' # Replace with your Jenkins username
  • JENKINS_ENABLED: This must remain true.

  • JENKINS_URL: The base URL for your Jenkins application (exclude the port number).

  • JENKINS_PORT: Specify the port (default is 8765).

  • JENKINS_API_TOKEN: Add the API token for your Jenkins account.

  • JENKINS_USERNAME: Add your Jenkins username.

SonarQube Configuration

# SonarQube Configuration

SONAR_ENABLED=true

SONAR_URL='http://X.X.X.X' # Replace with your SonarQube URL (without port)

SONAR_PORT='8765' # Replace with your port if not default (8765)

SONAR_API_KEY='<API_KEY>' # Replace with your SonarQube API Key
  • SONAR_ENABLED: This must remain true.

  • SONAR_URL: The base URL for your SonarQube application (exclude the port number).

  • SONAR_PORT: Specify the port (default is 8765).

  • SONAR_API_KEY: Add the API token for your SonarQube account.

6. Run Installation Script

sudo chmod +x install-deb.sh

./install-deb.sh <ORG_CODE>

7. Check the DevDynamics Daemon Service

sudo systemctl status devdynamics
 
sudo journalctl -u devdynamics

Configuration Notes

  • Modify configuration values carefully

  • Do not change REQUEST_SIZE_THRESHOLD_IN_BYTES or DD_API_KEY

  • Ensure all URLs and credentials are correct.

Support

For installation issues or questions, contact:

  • Additional Support: Use Intercom chat on the DevDynamics website

PreviousTest SuiteNextMetrics

Last updated 2 months ago

ORG_CODE: Get your OrgID from .

DD_API_KEY: Get your OrgID and API key from .

Email:

https://app.devdynamics.ai/settings/organisation
https://app.devdynamics.ai/settings/organisation
support@devdynamics.ai