Skip to content

Dev_Getting Started on UNIX based Systems

Jump to bottom
Isabelle Guyon edited this page Sep 8, 2017 · 13 revisions

If you are a developer and want to help build CodaLab, this page will explain how to to get started.

Installing Prerequisites for Linux

CodaLab utilizes Docker(CE) with Python version 2.7 and Django version 1.7, which allows for supporting development on local machines with Windows, Linux, Mac and BSD. If something is broken, please open a new issue.

In this section, we will walk you through installing Docker and other prerequisites.

Assuming a fresh Linux install the following guide and walk-through should get you started.

  1. Install Git.

    Git Install Guide

    Run: sudo apt-get install git

  2. Install Docker-CE for Ubuntu/Linux Docker Install Page

Note: The Linux installation differs from other installations

Follow the instructions from the link above to install Docker. It is recommended to use the install from the repository method.

Outline of Docker Install Steps:

  • Update apt package index
  • Install packages to allow apt to use a repository over HTTPS:
  • Add Docker’s official GPG key:
  • Verify the key fingerprint
  • Set up the Docker stable repository.
  • Update apt package index
  • Install the latest version of Docker CE or a specific version if you desire.
  • Verify that Docker CE is installed

On Ubuntu you also need to follow post install instructions: Docker Post Install

  • Create the docker group.
  • Add your user to the docker group.
  • Log out and log back in so that your group membership is re-evaluated.
  • Configure Docker to start on boot

After following these steps you should be ready to clone the repository locally, setup the environment variables for it, and run codalab locally in development conditions.

Clone this wiki locally