Installing a Development Arvados Instance¶

Arvados is primarily intended as a system to be run on large server clusters. For developers, we have provided a process to build and deploy the Arvados system in Docker containers on a single machine.

1. Download the Arvados source and switch to the appropriate branch.
   1. git clone git://git.curoverse.com/arvados.git
   2. cd arvados/docker
   3. git checkout 2221-complete-docker
2. Install the Arvados servers in Docker containers.
   1. Install the Docker server. Instructions for downloading and installing Ubuntu packages can be found at http://docs.docker.io/en/latest/installation/ubuntulinux/.
   2. Run ./build.sh to configure and build Arvados in Docker containers.
      1. More thorough documentation can be found in the docker/README.md file in the source distribution.
3. Install the client SDKs. After following those instructions, install the client libraries on your workstation as well.
   1. ./install_sdk.sh should install all of the necessary tools.
   2. If it does not work for you, try installing these by hand:
      1. RVM -- if you do not already have RVM installed on your workstation, install it now.
         1. sudo apt-get install curl libcurl3 libcurl3-gnutls libcurl4-openssl-dev python-pip
         2. curl -sSL https://get.rvm.io | bash -s stable
         3. source ~/.rvm/scripts/rvm
         4. rvm install 2.1.0
      2. Install the arvados-cli gem:
         1. gem install arvados-cli
         2. sudo pip install --upgrade httplib2

Once you have installed the servers and started them with arvdock start, and installed the client libraries, you should be able to work through the user tutorials to upload data into Arvados and run simple Crunch jobs in debug mode.