Merge branch 'master' into 3762-delete-list-worker
[arvados.git] / doc / install / pre-built-docker.html.textile.liquid
1 ---
2 layout: default
3 navsection: installguide
4 title: Install pre-built docker images
5 ...
6
7 {% include 'notebox_begin' %}
8 This method is easy, but is not suitable for production use. It is still in development: some features do not work yet.
9 * Websockets service is not enabled. This means Workbench auto-refresh and web upload (and some other features) do not work.
10 * The node manager is not enabled. Two worker containers are brought up at startup.
11 * The automatic network configuration allows you to log in to Workbench from a browser _running on the same host as docker_. Connecting from other hosts will require additional configuration (not covered here).
12 {% include 'notebox_end' %}
13
14 This installation method is appropriate for testing and evaluation on one computer. *For production use, this installation method is not recommended*.
15
16 h2. Prerequisites
17
18 # A GNU/Linux (virtual) machine
19 # A working Docker installation (see "Installing Docker":https://docs.docker.com/installation/)
20 # curl
21
22 h2. Verify prerequisites
23
24 Make sure that @curl@ and @docker@ are installed on your system, and that you are in the docker group (see "Installing Docker":https://docs.docker.com/installation/).
25
26 <notextile><pre><code>~$ <span class="userinput">which curl</span>
27 /usr/bin/curl
28 ~$ <span class="userinput">docker.io --version</span>
29 Docker version 1.2.0-dev, build dc243c8
30 ~$ <span class="userinput">groups</span>
31 yourusername sudo fuse docker
32 </code></pre></notextile>
33
34 h2. Download and install Arvados.
35
36 <notextile>
37 <pre><code>~$ <span class="userinput">\curl -sSL get.arvados.org | bash</span>
38 </code></pre></notextile>
39
40 This command will download the latest copy of the Arvados docker images. It also gets the arvdock command and saves it in the current working directory. It then uses arvdock to spin up Arvados. Depending on the speed of your internet connection, it can take a while to download the Arvados docker images.
41
42 If you prefer, you can also download the installation script and inspect it before running it. @get.arvados.org@ redirects to "https://raw.githubusercontent.com/curoverse/arvados-dev/master/install/easy-docker-install.sh":https://raw.githubusercontent.com/curoverse/arvados-dev/master/install/easy-docker-install.sh, which is the installation script.