Knowledge

How to install Buddy GO on Mac OS X

Install Docker for Mac

  1. Download the Mac OS X version from https://download.docker.com/mac/stable/Docker.dmg.

  2. Double-click on Docker.dmg to open the installer and drag the Docker icon to the Applications folder.

    Installing Docker #1
    Installing Docker #1

    Authorize Docker.app with your system password to proceed. Privileged access is needed to install networking components and links to the Docker apps.

  3. Double-click Docker.app to start Docker: a whale icon in the status bar will indicate that Docker is running, and accessible from a terminal.

    Installing Docker #2
    Installing Docker #2
  4. Now we have to assign RAM to Docker that will be used by Buddy GO. Click the whale icon in the status bar and go to Preferences:

    Docker Preferences location
    Docker Preferences location
  5. Set the memory to 4 GB:

    Assigning RAM to Docker Compose
    Assigning RAM to Docker Compose

    NOTE: If you're planning to run heavy workloads with Buddy GO we recommend assigning at least 8GB of RAM. You can read more about the system requirements of Buddy GO here.

Install Buddy GO

With the Docker all set, we're ready to install Buddy GO.

Run the following in the terminal:

    curl -sSL https://get.buddy.works | sh && sudo buddy install

This command will download 2GB of Docker image. If you are having any trouble with the download, please contact us for assistance.

Buddy GO Installation process
Buddy GO Installation process

NOTES:

  • Buddy uses ports 80, 443 and 22 on the installation server. You will be asked for an alternative port if one of the ports is unavailable.

  • By default Buddy installs in your HOME directory. You can change the storage path for databases, repositories, and settings in the configuration settings

  • If you are connecting through proxy server, add HTTP_PROXY environmental variable pointing to the proxy address. You can do this by calling in bash:

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

Set up your workspace

When the installation is over, Buddy GO will launch and the URL to your instance will appear.

Copy and paste the link to your browser to begin.

Installation summary with workspace IP
Installation summary with workspace IP

Buddy GO uses a self-signed certificate for SSL. You may see a warning about this upon accessing your workspace for the first time. There's nothing to worry about: you can safely proceed to the website.

Provide the details of your first workspace:

Buddy workspace
Buddy workspace

Congratulations!

You've just successfully installed and configured Buddy GO on your own server. Make sure to check out our guides for inspiration and some good practice that will help you get started.

Good luck in your ventures!
The Buddy Team
Twitter.com/BuddyGit

Download On-Premises Installation
esc

Sign up for free

No setup fees. No requirements. No obligation.

or sign up with