1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/docs/contributing/software-required.md
Justin Cormack cecd0de3a9 First pass updating CONTRIBUTING
This largely removes references to Docker where possible.

The HOWTO guides are still Docker docs and refer to Docker not
moby, so the next step is to rework these as Moby docs and put
them in `docs/` in this repo.

Signed-off-by: Justin Cormack <justin.cormack@docker.com>
2017-11-03 11:54:55 +00:00

2.6 KiB

Get the required software for Linux or macOS

This page explains how to get the software you need to use a Linux or macOS machine for Moby development. Before you begin contributing you must have:

  • a GitHub account
  • git
  • make
  • docker

You'll notice that go, the language that Moby is written in, is not listed. That's because you don't need it installed; Moby's development environment provides it for you. You'll learn more about the development environment later.

Task 1. Get a GitHub account

To contribute to the Moby project, you will need a GitHub account. A free account is fine. All the Moby project repositories are public and visible to everyone.

You should also have some experience using both the GitHub application and git on the command line.

Task 2. Install git

Install git on your local system. You can check if git is on already on your system and properly installed with the following command:

$ git --version

This documentation is written using git version 2.2.2. Your version may be different depending on your OS.

Task 3. Install make

Install make. You can check if make is on your system with the following command:

$ make -v

This documentation is written using GNU Make 3.81. Your version may be different depending on your OS.

Task 4. Install or upgrade Docker

If you haven't already, install the Docker software using the instructions for your operating system. If you have an existing installation, check your version and make sure you have the latest Docker.

To check if docker is already installed on Linux:

docker --version
Docker version 17.10.0-ce, build f4ffd25

On macOS or Windows, you should have installed Docker for Mac or Docker for Windows.

$ docker --version
Docker version 17.10.0-ce, build f4ffd25

Tip for Linux users

This guide assumes you have added your user to the docker group on your system. To check, list the group's contents:

$ getent group docker
docker:x:999:ubuntu

If the command returns no matches, you have two choices. You can preface this guide's docker commands with sudo as you work. Alternatively, you can add your user to the docker group as follows:

$ sudo usermod -aG docker ubuntu

You must log out and log back in for this modification to take effect.

Where to go next

In the next section, you'll learn how to set up and configure Git for contributing to Moby.