Public | Automated Build

Last pushed: a year ago
Short Description
OACIS tutorial image
Full Description


You can experience OAICS.

Quick Start

  1. Setup docker engine (version 1.8 or later is required.)

  2. Start an oacis instance

     docker run --name oacis_tutorial -p 3000:3000 -dt oacis/oacis_tutorial
     docker logs -f oacis_tutorial # wait for boot. exit via Ctrl + C
    • OACIS is ready when you get the following logs.

        Progress: |====================================================================|
        bundle exec rails s -d -b
        => Booting Thin
        => Rails 4.2.0 application starting in production on
        => Run `rails server -h` for more startup options
        ServiceWorker started.
        JobSubmitterWorker started.
        JobObserverWorker started.
        + echo booted
        + child=807
        + wait 807
        + tail -f /dev/null
    • The default port is 3000. (You can choose another port like -p 3001:3000.)
    • (for Mac or Windows users) Run the above command in Docker Quickstart Terminal.
  3. Access OACIS web interface

    • You can access OACIS web interface via a web browser.(http://localhost:3000)
    • (Mac or Windows) Access instead of localhost.
  4. Try Simulations

    • Several simulators have been installed.
    • You can see how to use each simulator on About tab of Simulator page

Stop and Restart

Find a running oacis_tutorial container.

docker ps
#CONTAINER ID        IMAGE                        COMMAND                        CREATED         STATUS        PORTS                        NAMES
#3edbc17ee5e4        oacis/oacis_tutorial:latest  "./oacis_docker_cmd/o"         1 days ago      Up 23 hours>3000/tcp       oacis_tutorial

Stop the container.

docker stop oacis_tutorial

Find the stoped oacis_tutorial container.

docker ps -a
#CONTAINER ID        IMAGE                        COMMAND                        CREATED         STATUS                  PORTS                        NAMES
#3edbc17ee5e4        oacis/oacis_tutorial:latest  "./oacis_docker_cmd/o"         1 days ago      Exited (0) 1 week ago>3000/tcp       oacis_tutorial

Restart the container.

docker start oacis_tutorial
docker logs -f oacis_tutorial

Revome the container.

docker stop oacis_tutorial
docker rm -v oacis_tutorial

Logging in the container

By logging in the container, you can update the configuration of the container.
For instance, you can install additional packages, set up ssh-agent, and see the logs.

To login the container as a normal user, run

docker exec -it -u oacis oacis_tutorial bash -l

To login as the root user, run

docker exec -it oacis_tutorial bash


Linux users must set up firewall for oacis_docker, otherwise anyone can access your oacis web-browser interface.
iptables is an application program for setting up firewall and docker-engine makes iptables configulations.
Run the following command as root on host machine to overwrite the configulations.

iptables -I FORWARD -i eth+ -o docker0 -p tcp -m tcp --dport 3000 -j DROP

If you are also using wifi, you need to run the following command additionally.

iptables -I FORWARD -i wlan+ -o docker0 -p tcp -m tcp --dport 3000 -j DROP

Note: iptables configurations are deleted when host OS reboots.


  • Just send your feedback to us!
    • oacis-dev _at_ (replace _at_ with @)
    • We appreciate your questions, feature requests, and bug reports. Do not hesitate to give us your feedbacks.
  • You'll have announcements of new releases if you join the following google group. Take a look at


  • oacis_docker_tutorial is a part of OACIS.
  • OACIS and oacis_docker_tutorial are published under the term of the MIT License (MIT).
  • Copyright (c) 2014-2016 RIKEN, AICS
Docker Pull Command