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://[email protected]/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.ORG_CODE
: Get your OrgID from https://app.devdynamics.ai/settings/organisation.REQUEST_SIZE_THRESHOLD_IN_BYTES
: Do not modify this value.DD_API_KEY
: Get your OrgID and API key from https://app.devdynamics.ai/settings/organisation.
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 remaintrue
.GITHUB_URL
: The base URL for your GitHub application (exclude the port number).GITHUB_PORT
: Specify the port (default is443
).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 remaintrue
.BITBUCKET_URL
: The base URL for your Bitbucket application (exclude the port number).BITBUCKET_PORT
: Specify the port (default is80
).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 remaintrue
.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 remaintrue
.JENKINS_URL
: The base URL for your Jenkins application (exclude the port number).JENKINS_PORT
: Specify the port (default is8765
).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 remaintrue
.SONAR_URL
: The base URL for your SonarQube application (exclude the port number).SONAR_PORT
: Specify the port (default is8765
).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
orDD_API_KEY
Ensure all URLs and credentials are correct.
Support
For installation issues or questions, contact:
Email: [email protected]
Additional Support: Use Intercom chat on the DevDynamics website
Last updated