---
layout: default
navsection: installguide
title: Installing with Docker
...
h2. Purpose
This installation method is appropriate for local testing, evaluation, and development. For production use, this method is not recommended.
h2. Prerequisites
# A GNU/Linux (virtual) machine
# A working Docker installation (see "Installing Docker":https://docs.docker.com/installation/)
h2. Download the source tree
~$ cd $HOME # (or wherever you want to install)
~$ git clone https://github.com/curoverse/arvados.git
~$ cd arvados/docker
~$ cp config.yml.example config.yml
PUBLIC_KEY_PATH ARVADOS_USER_NAME API_HOSTNAME API_AUTO_ADMIN_USERThen build the docker containers (this will take a while):
~$ ./build.sh
...
Step 7 : ADD generated/setup.sh /usr/local/bin/setup.sh
---> d7c0e7fdf7ab
Removing intermediate container f3d81180795d
Step 8 : CMD ["/usr/bin/supervisord", "-n"]
---> Running in 84c64cb9f0d5
---> d6cbb5002604
Removing intermediate container 84c64cb9f0d5
Successfully built d6cbb5002604
date >shell-image
~$ docker.io images
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
arvados/shell latest d6cbb5002604 10 minutes ago 1.613 GB
arvados/sso latest 377f1fa0108e 11 minutes ago 1.807 GB
arvados/keep latest ade0e0d2dd00 12 minutes ago 210.8 MB
arvados/workbench latest b0e4fb6da385 12 minutes ago 2.218 GB
arvados/doc latest 4b64daec9454 12 minutes ago 1.524 GB
arvados/compute latest 7f1f5f7faf54 13 minutes ago 1.862 GB
arvados/slurm latest f5bfd1008e6b 17 minutes ago 1.573 GB
arvados/api latest 6b93c5f5fc42 17 minutes ago 2.274 GB
arvados/passenger latest add2d11fdf24 18 minutes ago 1.738 GB
arvados/base latest 81eaadd0c6f5 22 minutes ago 1.463 GB
arvados/debian 7.6 f339ce275c01 6 days ago 116.8 MB
arvados/debian latest f339ce275c01 6 days ago 116.8 MB
arvados/debian wheezy f339ce275c01 6 days ago 116.8 MB
crosbymichael/skydock latest e985023521f6 3 months ago 510.7 MB
crosbymichael/skydns next 79c99a4608ed 3 months ago 525 MB
crosbymichael/skydns latest 1923ce648d4c 5 months ago 137.5 MB
~$ ./build.sh clean
~$ ./build.sh realclean
~$ ./build.sh deepclean
~$ ./arvdock -h
usage: ./arvdock (start|stop|restart|test) [options]
./arvdock start/stop/restart options:
-d[port], --doc[=port] Documentation server (default port 9898)
-w[port], --workbench[=port] Workbench server (default port 9899)
-s[port], --sso[=port] SSO server (default port 9901)
-a[port], --api[=port] API server (default port 9900)
-c, --compute Compute nodes (starts 2)
-v, --vm Shell server
-n, --nameserver Nameserver
-k, --keep Keep servers
--ssh Enable SSH access to server containers
-h, --help Display this help and exit
If no options are given, the action is applied to all servers.
./arvdock test [testname] [testname] ...
By default, all tests are run.
~$ ./arvdock start
sso_server
Starting container:
/usr/bin/docker.io run -d -i -t -p 9901:443 --name sso_server arvados/sso
api_server
Starting container:
/usr/bin/docker.io run -d -i -t -p 9900:443 --name api_server --link sso_server:sso arvados/api
keep_server_0
Starting container:
/usr/bin/docker.io run -d -i -t -p 25107:25107 --name keep_server_0 -v /tmp/tmp.aCSx8Pq6Wb:/dev/keep-0 --link api_server:api arvados/keep
keep_server_1
Starting container:
/usr/bin/docker.io run -d -i -t -p 25108:25107 --name keep_server_1 -v /tmp/tmp.m4OQ9WB73G:/dev/keep-0 --link api_server:api arvados/keep
doc_server
Starting container:
/usr/bin/docker.io run -d -i -t -p 9898:80 --name doc_server arvados/doc
*****************************************************************
You can access the Arvados documentation at http://localhost:9898
*****************************************************************
workbench_server
Starting container:
/usr/bin/docker.io run -d -i -t -p 9899:80 --name workbench_server --link api_server:api arvados/workbench
*****************************************************************
You can access the Arvados workbench at http://localhost:9899
*****************************************************************
https://localhost:9899