Installation using Docker

Docker works natively on Linux, Mac OSX, and Windows 10. If you are using an older version of Windows (and some older versions of Mac OSX), you will need to install Docker Toolbox.

Choose either Docker Toolbox, Docker Native (Windows/OSX), or Docker Native (Ubuntu) to install Docker.

Docker Toolbox

Install Docker-Toolbox, which installs several applications including Docker, Docker Machine, and Docker Compose.

  • Create Docker-Machine Image

    The command below will create a 100GB volume for development. This is a very large volume and can be adjusted. Make sure to create a volume greater than 30GB.

    docker-machine create --virtualbox-disk-size 100000 -d virtualbox dev
    
  • Start Docker-Machine Image

    docker-machine start dev  # if not already running
    # export environment variables
    eval $(docker-machine env dev)
    
  • Get the Docker IP address (docker-machine ip dev)

Docker Native (Ubuntu)

Follow instructions [here](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/).

Docker Native (Windows/OSX)

Following instructions (for Mac)[https://docs.docker.com/docker-for-mac/install/] or (for Windows)[https://docs.docker.com/docker-for-windows/install/].

Building and Configuring Containers

  • Run Docker Compose

    docker-compose build
    

    Be Patient … If the containers build successfully, then start the containers

    docker-compose up
    

    Note that you may need to build the containers a couple times for everything to converge

  • Login to container

    The docker-compose file creates a default user and password. Below are the defaults but can be overridden by setting environment variables.

    username: user@seed-platform.org
    password: super-secret-password
    

Note

Don’t forget that you need to reset your default username and password if you are going to use these Docker images in production mode!