Install required tools on Linux
The following instructions were followed to install the required tools on Linux
Note: This tutorial was written using Ubuntu 18.04.2 LTS. You can refer to the linked documentation within the dependencies sections for instructions for other systems.
Dependencies:
Docker CE is the docker application run on your machine to enable use of docker features. The latest version is not a requirement for this development stack, however it is always advised to keep up to date as improvements and security fixes are released frequently.
Yarn is package manager for installing new software packages on your system and is used to run the Portainer dev environment .
Node.JS is a JavaScript package used when building applications leveraging networking, such as Portainer. Version 12 or greater is required.
Golang is an open-source language, from which we build a majority of the Portainer software. Version 1.15 is required.
Wget is a package for retrieving files using common internet protocols such as HTTP and FTP.
Docker
Note: The below instructions were run on Ubuntu, for up-to-date instructions on this and other Linux flavours refer to the official Docker CE documentation.
You must configure the Docker repository before installing Docker.
Configure Docker repository
Update your system's packages:
Install required packages to use repos over HTTPS:
Install the official GPG key for Docker:
Verify that you now have the key with the fingerprint 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88 :
Correct output should be:
Use the following command to set up the stable repository:
Installing Docker
Update your system's packages:
Install Docker and it's associated packages:
Verify that Docker was correctly installed and is running on your system:
This command should download a test image, run it in a container and print an informational message then exit.
Tip: It is always a good idea to install software based on up-to-date instructions from the offical vendor. This guide was written based on the official Docker help doc for installation on Linux which can be found here.
That’s it for Docker!
Yarn
Note: If you are running a different Linux flavour than Ubuntu, you can refer to the official installation instructions for yarn on Linux here
Installation Instructions:
Running the below command in the terminal will configure the yarn repository on your system:
Update your system's packages & install yarn:
Confirm Yarn has successfully installed by running the below command in the terminal
The current version of yarn should now print out in your terminal. This indicates that yarn is successfully installed and running on your system.
Troubleshooting:
If you are receiving errors when trying to install or use yarn, you can refer to their official documentation here.
Node.JS
Note: This tutorial will make use of NVM to install Node.JS (Node.JS version 12 or greater is required). NVM allows install of multiple different versions of Node.JS on a system & provides an easy way to switch between them. You can find the official documentation for NVM here.
Installing or Updating Node.JS
Install or update Node.JS to the latest version by entering the below command in the terminal:
Check if Node is installed on your system:
The latest version of Node.JS should now print out.
Troubleshooting:
If you cannot install or update Node.JS, refer to the official NVM documentation here.
Golang
Note: Go version 1.15 is required. You can refer to offical go documentation here for up to date instructions. If you are upgrading from an older version of Go you must first remove the existing version.
Installing GO using a Linux Tar file:
Download the appropriate version of go for your system appropriate for your system and navigate to where it was downloaded.
Extract it to the /usr/local directory:
Add /usr/local/go/bin to the PATH environment variable inside your shell profile (example using bash) :
Note: You may need to logout and log back in for this to take effect.
Verify GO is installed correctly by following the Test your installation section of the offical documentation here.
Troubleshooting:
If you are having errors trying to install or use GO, you can refer to the Getting help section of the official guide here.
Wget
Installing Wget on Linux is simple enough. Just run the apt-get install wget
command in the terminal.
Troubleshooting:
If you are having errors trying to install or use Wget, you can refer to the official guide here.
Last updated
Was this helpful?