Install Self-Hosted
Get Started on Cloud
BasicsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesAgents & Tunnels

Linux

View as Markdown

This tutorial shows how to install Buddy self-hosted on a Linux distribution.

What is the Buddy App Self-Hosted Version?

If you are wondering what is Buddy, it is a powerful CI/CD automation tool designed to streamline web development. While many users access the Buddy app via the cloud, this guide explains how to install the self-hosted version on your own Linux infrastructure.

Info
Note: This documentation is for installing Buddy Works on your own Linux servers (On-Premises). If you prefer our managed cloud CI/CD platform, please head over to buddy.works to create an account.
Tip
If you are using Ubuntu, read the dedicated Ubuntu installation guide.
Warning
All commands listed in the article must be run as root.

Requirements for Buddy Self-Hosted on Linux

Before installing the Buddy app, ensure your Linux server meets the requirements. Buddy requires Docker Engine and Docker Compose to run. Connect to your server and follow the installation instructions:

Warning
CPU for Buddy self-hosted installation requires AVX (Advanced Vector Extensions) support.

Installing Buddy

Connect to the server and start installation

Connect to the server using SSH and run this command to download the Docker image and install Buddy:

bash
curl -sSL https://get.buddy.works | sh && buddy install
$
Info
By default, Buddy uses ports 80, 443, and 22 for communication. If these ports are not available, the installer asks to provide alternative ports.
Tip
By default, Buddy installs in the HOME directory. You can change the storage path for databases, repositories, and settings using the CLI.
Tip

If you're connecting to the server through a proxy, add the HTTP_PROXY environment variable on the Linux server. Run this command:

bash
export HTTP_PROXY="http://proxyIp:proxyPort"
$

Setting up your workspace

  1. Use the URL provided in the summary to access Buddy self-hosted.

Image loading...Installation summary with workspace IP

Info
By default, Buddy self-hosted uses a self-signed SSL certificate. Because of that, you can get a security warning from your browser when you access the instance for the first time. There’s nothing to worry about! You can safely open the address.
  1. Provide the details of your first workspace.
Success
Congratulations! You have successfully installed and configured Buddy on your own server. Check out the Quickstart section for tips on getting started.

Last modified on Mar 18, 2026

Previous pageDigitalOceanNext pageUbuntu