Docker Installation

Getting your own development environment.

Preparing Your System

  1. You need to install docker in your system. The installation guide covers many operating systems but for now we only support Linux.
  2. We are using an orchestration tool for docker called docker-compose that helps us automate the procedure of initiating our docker containers required for development. Installation instructions can be found in Compose’s documentation. Version required: 1.0.1 or newer.

Build the Environment

When you want to start contributing...

  1. Fork the main ReMo repository.

  2. Clone your fork to your local machine:

    $ git clone git@github.com:YOUR_USERNAME/remo.git remo
    (lots of output - be patient...)
    $ cd remo
    
  3. Configure your local ReMo installation:

    $ cp remo/settings/local.py-docker-dist remo/settings/local.py
    
  4. Choose a HMAC_KEY:

    For development purposes you can uncomment the key ‘2012-06-15’ with HMAC_KEYS dictionary in your local.py:

    HMAC_KEYS = {
       '2012-06-15': 'some key',
    }
    
  5. Update the product details:

    $ docker-compose run web python manage.py update_product_details -f
    
  6. Create the database tables and run the migrations:

    $ docker-compose run web python manage.py migrate --noinput
    
  7. Create your own admin account:

    $ docker-compose run web ./manage.py createsuperuser
    
  8. Add demo users:

    $ docker-compose run web ./manage.py loaddata demo_users
    
  9. Add demo functional areas:

    $ docker-compose run web ./manage.py loaddata demo_functional_areas
    
  10. Add demo events:

    $ docker-compose run web ./manage.py loaddata demo_events
    

Running ReMo

  1. Run ReMo:

    $ docker-compose up
    (lots of output - be patient...)
    
  2. Develop!