Automatic single-node install

Note:

This installation method is not fully implemented, which is why this page is not yet listed in the table of installation options or in the left nav.

This method sets up a new Arvados cluster using a single host/VM. It is the easiest way to get a new production cluster up and running.

A single-node installation supports all Arvados functionality at small scale. Substantial workloads will require additional nodes and configuration steps.

Prerequisites

You will need:

a server host running Debian 10 (buster).
a unique 5-character ID like x9999 for your cluster (first character should be [a-w] for a long-lived / production cluster; all characters are [a-z0-9]).
a DNS name like x9999.example.com that resolves to your server host (or a load balancer / proxy that passes HTTP and HTTPS requests through to your server host).
a Google account (use it in place of example@gmail.com.example in the instructions below).

Initialize the cluster

# echo > /etc/apt/sources.list.d/arvados.list "deb http://apt.arvados.org/buster buster main"
# apt-get update
# apt-get install arvados-server-easy
# arvados-server init -type production -cluster-id x9999 -controller-address x9999.example.com -admin-email example@gmail.com.example

When the “init” command is finished, navigate to the link shown in the terminal (e.g., https://x9999.example.com/?api_token=zzzzzzzzzzzzzzzzzzzzzz). This will log you in to your admin account.

Enable login

Follow the instructions to set up Google login or another authentication option.

After updating your configuration file (/etc/arvados/config.yml), restart the server to make your changes take effect:

# systemctl restart arvados-server

Previous: Set up Docker