Buddy CLI

Installing Buddy On-Premises also installs the Buddy CLI. The CLI is used to operate, manage, and configure your on-premises installation.

Basic commands

All commands listed in the article must be run as root.

  • buddy start – starts the application
  • buddy stop – stops the application
  • buddy restart – restarts the application
  • buddy feedback – sends feedback to Buddy customer support
  • buddy version – shows the CLI and Buddy On-Premises version
  • buddy terms – shows the Buddy On-Premises Software License Agreement

Advanced commands

  • buddy configure – configures the application.
  • buddy [--yes] [--full] backup – creates a backup of the app. Use the --yes flag to create a backup without the need for user interaction and delete old backups. Use the --full flag to include the cache in the backup.
  • buddy [--yes] restorerestores application from a backup file. Use the --yes flag to use the latest backup available to the system.
  • buddy clear-cache – clears the Docker cache (docker prune), filesystems, and DinD disk contents.
  • buddy status – shows the status of the application and its components.
  • buddy diagnose – runs diagnostics on your installation. Shows tips for fixing problems it finds.
  • buddy [--yes] update – shows if a new version of the app or the CLI is available and provides installation instructions. Use the --yes flag to automatically download and apply available updates.
  • buddy [--yes] uninstall – uninstalls Buddy On-Premises. You must remove the CLI manually. Use the --yes flag to do it without requiring user interaction.
  • buddy set – configures integrations through the CLI. Run the command to get the full list of things you can configure. Run buddy set {INTEGRATION_NAME} to learn more about configuring the selected integration.
  • buddy fix-mysql – fixes MySQL issues. Run only when buddy diagnose tells you to do so.
  • buddy install-worker – installs a new worker for your instance through a CLI wizard.

CLI configuration options

When you run buddy configure, the CLI shows the options listed below. To configure an option, type the corresponding number and press Enter.

  1. Exit configuration
  2. Custom domain – sets a custom domain used to access Buddy On-Premises through the browser.
  3. Custom domain SSL certificate – sets a valid SSL certificate for the custom domain.
  4. Application data path – moves application data to a different partition or disk.
  5. IP & ports – sets connection IP's and ports:

    • external IP – used to access the instance through the browser
    • server IP – the IP address to which the application is bound; by default, all application interfaces are bound to this address
    • HTTPS port (default: 443)
    • HTTP port (default: 80)
    • Git SSH port (default: 22)
  6. Reset Workspace owner password – resets the owner password and provides the email address and a one-time token to sign in after the reset.
  7. Build CPU limit – limits the number of CPUs used by pipelines.
  8. Build memory limit – limits the RAM memory used by pipelines.
  9. Concurrent executions limit – limits the number of pipelines that can run at the same time.
  10. Parallel actions limit – limits the number of actions that can run at the same time within one pipeline.
  11. SMS serviceconfigures SMS messages sent by Amazon AWS as notifications.
  12. Repo max file size – sets the maximum size of files you can push to a repository when using Buddy Git Hosting.
  13. HAProxy ciphers – changes HAProxy ciphers to customize security policies for connected clients.
  14. Application memory management – adjusts the amount of memory used by the application's components.
  15. API requests limit – adjusts the rate limits for accessing resources. By default, users can make 1000 requests to a resource every 15 minutes.
  16. Telemetryenables or disables telemetry.
  17. Pipelines worker assignment – specifies if pipelines are automatically re-assigned to a different worker if the worker vCPU load exceeds 100%.

Get Started

Sign up for free and deploy your project in less than 10 minutes.