Arvados components run on GNU/Linux systems, and do not depend on any particular cloud operating stack. It is developed primarily on Debian and Ubuntu GNU/Linux.
-Arvados components can be installed and configured in a number of different ways. Step-by-step instructions are available for a few specific setups:
-# "Install pre-built docker images":pre-built-docker.html *(quickest)*
-# "Build your own docker images":install-docker.html from source
-# "Manual installation":install-manual-prerequisites.html (most flexible)
+Arvados components can be installed and configured in a number of different ways. Step-by-step instructions are available for a few specific installation methods:
+* "Install pre-built docker images":pre-built-docker.html *(quickest)*
+* "Build your own docker images":install-docker.html (from source)
+* "Manual installation":install-manual-prerequisites.html (most flexible)
+
+For local evaluation and testing on a single computer, use one of the docker installation methods.
For production use or evaluation at scale, the "manual installation":install-manual-prerequisites.html is more appropriate. This method assumes you have a number of (virtual) machines at your disposal for running the various Arvados components.
title: Build and install docker images
...
-This installation method is appropriate for local testing, evaluation, and development. For production use, this method is not recommended.
+This installation method is appropriate for testing, evaluation and development on one computer. *For production use, this installation method is not recommended*.
h2. Prerequisites
...
{% include 'notebox_begin' %}
-This method is easy, but is not yet suitable for production use. It is still in development: some features do not work yet.
+This method is easy, but is not suitable for production use. It is still in development: some features do not work yet.
* Websockets service is not enabled. This means Workbench auto-refresh and web upload (and some other features) do not work.
* The node manager is not enabled. Two worker containers are brought up at startup.
* 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).
{% include 'notebox_end' %}
-First, 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/).
+This installation method is appropriate for testing and evaluation on one computer. *For production use, this installation method is not recommended*.
+
+h2. Prerequisites
+
+# A GNU/Linux (virtual) machine
+# A working Docker installation (see "Installing Docker":https://docs.docker.com/installation/)
+# curl
+
+h2. Verify prerequisites
+
+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/).
<notextile><pre><code>~$ <span class="userinput">which curl</span>
/usr/bin/curl
yourusername sudo fuse docker
</code></pre></notextile>
-Download and install Arvados.
+h2. Download and install Arvados.
<notextile>
<pre><code>~$ <span class="userinput">\curl -sSL get.arvados.org | bash</span>