Instructions for running FermiBottle on Linux systems

Installing Docker

FermiBottle requires Docker, which happily runs natively on Linux. If you do not already have docker installed you can install it using either your system's package manager, or one of the official docker binaries.

If you are running a popular distribution of Linux such as Ubuntu, Debian, Fedora, or CentOS please refer to your distributions page here:

• ubuntu
• debian
• centos
• fedora

Otherwise, check your system's package manager or help documentation.

Ubuntu 18.04

It seems the docker rpm repository does not yet have binaries for 18.04. Therefore you need to use the community repositories and enable permissions yourself.

1. Install docker sudo apt install docker.io
2. Allow your user account to use docker sudo usermod -a -G docker $USER
3. Start the docker daemon sudo systemctl start docker
4. Make the docker daemon a startup process sudo systemctl enable docker
5. Reboot.

Acquire the Docker Image

The FermiBottle image is a 3 Gigabyte file, currently hosted on dockerhub. You can download it directly over your internet connection after you have installed docker, or you can install it locally from a tarball provided by the Fermi Science Support Center.

Using DockerHub

docker pull fssc/fermibottle

Or using a local tarball

unzip fermibottle.tar.zip && docker load < fermibottle.tar

Create a container from the FermiBottle image (Linux)

1. Open a terminal and navigate to your desired working directory. This directory will be shared with the container so you can save work onto your local machine. cd my/awesome/shared/directory
2. Create a new FermiBottle container by copying this block of code into your command line and running it:

docker create -it --init \
-e HOST_USER_ID=`id -u $USER` \
-e DISPLAY=$DISPLAY \
-v /tmp/.X11-unix:/tmp/.X11-unix \
-v "`pwd`":/data \
-p 8888:8888 \
fssc/fermibottle

The big string of numbers and letters that gets printed out is your Container ID. That can be hard to remember so you may instead want to use the NAME. These should both be listed for you if you run docker ps -a.

If you were successful, we recommend you try not to make duplicate containers by running docker create again. It can be frustrating if you lose track of which one all of your work was done in if it wasn't saved to the shared directory.

Continue to Using the FermiBottle container.