Arvados™ Docs
WARNING - you are viewing the documentation for an old version of Arvados. For the latest version, click here.
  1. Overview
    1. Installation options
  2. Docker quick start
    1. Arvados-in-a-box
  3. Installation with Salt
    1. Planning and prerequisites
    2. Arvados in a VM with Vagrant
    3. Single host Arvados
    4. Multi host Arvados
  4. Arvados on Kubernetes
    1. Arvados on Kubernetes
    2. Arvados on Minikube
    3. Arvados on GKE
  5. Manual installation
    1. Planning and prerequisites
    2. Arvados package repositories
  6. Configuration
    1. Configuration files
    2. InternalURLs and ExternalURL
    3. Configuration reference
  7. Maintenance and upgrading
    1. Arvados upgrade notes
    2. Maintenance and upgrading
  8. Core
    1. Install API server and Controller
  9. Keep
    1. Install Keepstore servers
    2. Configure filesystem storage
    3. Configure S3 object storage
    4. Configure Azure Blob storage
    5. Install Keepproxy server
    6. Install Keep-web server
    7. Install Keep-balance
  10. User interface
    1. Set up web based login
    2. Install the websocket server
    3. Install Workbench
    4. Install Workbench 2
    5. Install Composer
  11. Additional services
    1. Set up a shell node
    2. Configure webshell
    3. Install the Git server
  12. Containers API (all)
    1. Install arvados/jobs image
  13. Containers API (cloud)
    1. Build a cloud compute node image
    2. Install the cloud dispatcher
  14. Compute nodes (Slurm or LSF)
    1. Set up a compute node with Docker
    2. Set up a compute node with Singularity
  15. Containers API (Slurm)
    1. Install the Slurm dispatcher
    2. Configure Slurm
    3. Test Slurm dispatch
  16. Containers API (LSF)
    1. Install the LSF dispatcher
  17. Additional configuration
    1. Configure container shell access
  18. External dependencies
    1. Install PostgreSQL 9.4+
    2. Install Ruby and Bundler
    3. Install Nginx
    4. Set up Docker

Arvados package repositories

On any host where you install Arvados software, you’ll need to add the Arvados package repository. They’re available for several popular distributions.

CentOS

Packages are available for CentOS 7. To install them with yum, save this configuration block in /etc/yum.repos.d/arvados.repo:

[arvados]
name=Arvados
baseurl=http://rpm.arvados.org/CentOS/$releasever/os/$basearch/
gpgcheck=1
gpgkey=http://rpm.arvados.org/CentOS/RPM-GPG-KEY-arvados

The Arvados signing key fingerprint is

pub   rsa2048 2010-11-15 [SC]
      B2DA 2991 656E B4A5 0314  CA2B 5716 5911 1078 ECD7
uid           [ unknown] Arvados Automatic Signing Key 
sub   rsa2048 2010-11-15 [E]

Debian and Ubuntu

Packages are available for recent versions of Debian and Ubuntu.

First, register the Arvados signing key in apt’s database:

# apt-get --no-install-recommends install curl gnupg2 ca-certificates
# curl https://apt.arvados.org/pubkey.gpg -o /etc/apt/trusted.gpg.d/arvados.asc

The Arvados package signing GPG key is also available via the keyservers, though they can be unreliable. To retrieve the signing key via keyserver.ubuntu.com:

# /usr/bin/apt-key adv --keyserver keyserver.ubuntu.com --recv 1078ECD7

The Arvados signing key fingerprint is

pub   rsa2048 2010-11-15 [SC]
      B2DA 2991 656E B4A5 0314  CA2B 5716 5911 1078 ECD7
uid           [ unknown] Arvados Automatic Signing Key 
sub   rsa2048 2010-11-15 [E]

As root, add the Arvados package repository to your sources. This command depends on your OS vendor and version:

OS version Command
Debian 11 (“bullseye”) echo "deb http://apt.arvados.org/buster bullseye main" | tee /etc/apt/sources.list.d/arvados.list
Debian 10 (“buster”) echo "deb http://apt.arvados.org/buster buster main" | tee /etc/apt/sources.list.d/arvados.list
Ubuntu 20.04 (“focal”)1 echo "deb http://apt.arvados.org/focal focal main" | tee /etc/apt/sources.list.d/arvados.list
Ubuntu 18.04 (“bionic”)1 echo "deb http://apt.arvados.org/bionic bionic main" | tee /etc/apt/sources.list.d/arvados.list

Note:

1 Arvados packages for Ubuntu may depend on third-party packages in Ubuntu’s “universe” repository. If you’re installing on Ubuntu, make sure you have the universe sources uncommented in /etc/apt/sources.list.

Retrieve the package list:

# apt-get update
Previous: Planning and prerequisites Next: Configuration files

The content of this documentation is licensed under the Creative Commons Attribution-Share Alike 3.0 United States licence.
Code samples in this documentation are licensed under the Apache License, Version 2.0.