Set up a macOS build environment
Was this helpful?
Was this helpful?
As an open source product, we encourage users to edit our code and submit patches to it. This article explains how to set up a local environment on Mac so you can build your own copy of Portainer and test your changes.
installs the Docker application and other Docker tools. The latest version is not a requirement for this development stack, however we recommend staying up to date with the latest improvements and security fixes.
is a package manager for installing new software packages on your system, and is used to run the Portainer development environment.
is a JavaScript package used when building applications that leverage networking, such as Portainer. Version 18 or later is required.
is the open source language that we use to build the majority of Portainer software. Version 1.18 of Golang is required.
Wget is a package used to retrieve files using common internet protocols such as HTTP and FTP.
Docker for macOS requires OSX Mountain Lion or later or it will not work. Please check that you have the right version before you begin.
then navigate to the Docker.dmg file and double-click to open. Drag and drop Docker into your applications folder. Authorize the installation using your system password then wait for Docker to finish installing.
To check that Docker installed successfully, double-click Docker inside your applications folder to start it. The whale icon should appear in your status bar, indicating Docker is running and accessible.
Click the Docker icon in the status bar then select About Docker Desktop from the menu (or a similarly named menu item, depending on your Docker version). A window should open, displaying the current version of Docker and its supporting software.
Running brew install yarn in the macOS terminal will install Yarn. To confirm it installed successfully, run yarn --version in the macOS terminal.
If successful, the current version of Yarn should print out in your terminal, indicating that it installed successfully and is running on your system.
To check if Node.JS is installed on your system, run node --version in your terminal. The current version of Node.JS should print out. If the version is version 6 or later, updating it to the latest version is optional (but we recommend it because it's good practice to stay up to date).
If you are running a version of Node.JS that is older than version 6, you must upgrade in order to run the Portainer development environment.
If Homebrew was installed at the same time as Yarn (using Homebrew), follow these steps to update Node.JS:
This procedure uses the Homebrew package manager. Go to learn how install it. If you don't want to use Homebrew, Yarn provides .
If you have issues installing or using Yarn, read their .
If you used Homebrew to install Yarn, Node.JS should have automatically installed alongside it. If not, you can install it by following the .
If you have issues installing or updating Node.JS using Homebrew, read .