Device Bay

Search

SearchSearch

Install and run

May 08, 20254 min read

1. Install docker

Red Hat Enterprise Linux (RHEL) 7.X

RHEL7 needs some additional steps prior to installing Docker CE Engine.

  1. Add the docker community edition repo
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
  1. Edit repo to add centos (centos is the open source free version of RHEL, at least up until RHEL 8)

Edit the /etc/yum.repos.d/docker-ce.repo, for example using nano with the command:

sudo nano /etc/yum.repos.d/docker-ce.repo

Add the following to the top or bottom of the file:

[centos-extras]
name=Centos extras - $basearch
baseurl=http://mirror.centos.org/centos/7/extras/x86_64
enabled=1
gpgcheck=0

Save the file, and run sudo yum update

Now, you should be able to run sudo yum install docker.

  1. Without extra configuration, all docker commands will need to be prefaced with sudo. For example, docker ps becomes sudo docker ps
  2. After installation, you may need to start the docker daemon:
sudo systemctl start docker

Red Hat Enterprise Linux (RHEL) 8 - untested

The above guide for RHEL may work, with the baseurl in [centos-extras] changed to https://mirror.centos.org/centos/8/extras/x86_64/. Also or alteratively, this guide may work.

Ubuntu

follow this guide for installation, and for configuring docker commands to work without sudo.

2a. Download and run published image

If you don’t plan to customize the voltage source user interface or back-end webserver, you may download a version from dockerhub. This version works on x86-64 architecture computers. It will not work on ARM-based computers like raspberry pi. To get an ARM-compatible image, you will have to build it yourself. See instructions in 2b.

Download:

docker pull sansseriff/dbay

Run:

docker run -d --restart unless-stopped --name dbay_container --log-opt max-size=10m --log-opt max-file=3 -p 80:80 sansseriff/dbay

The user interface should now be visible by typing 0.0.0.0 into the browser of the computer running docker. If docker was installed on a remote host computer on the same network, view the UI by directing the browser to the ip address of the host computer.

2b. Clone github repo and build container

If you need to customize the user interface or webserver, clone this repository, and rebuild the container:

git clone https://github.com/sansseriff/Isolated_Voltage_Source.git

You may customize backend python code in the backend/ directory.

In order to customize and rebuild the frontend javascript and html, you will need to have node installed. Inside the frontend/ folder, run npm install to install all the necessary libraries needed to work with svelte. Running npm run build, will rebuild the frontend to vanilla javascript & html and place it in backend/snspd_bias_control/ where the python backend webserver will find it.

When the code is ready to go, run this command in the root directory to build the container, using the instructions present in the local Dockerfile;

docker build -t dbay .

Then run the built container image:

docker run -d --restart unless-stopped --name dbay_container -p 80:80 dbay

The user interface should now be visible by typing 0.0.0.0 into the browser of the computer running docker. If docker was installed on a remote host computer on the same network, view the UI by directing the browser to the ip address of the host computer.

Various Useful Docker Commands

Docker commands needed for starting/stopping/updating a container

Build command:

 
docker build -t dbay .

run command:

to make a new container from updated image:

docker run -d --restart unless-stopped --name dbay_container -p 80:80 dbay

to run existing container

docker run -d -p 80:80 dbay -d --restart unless-stopped

Stop and remove existing container:

docker rm -f dbay_container

remove ‘dangling’ images.

If you remove a container and make a new image with the same name as an old one, the old image is not deleted. It loses it’s name and becomes a ‘dangling image’. Remove these with:

docker image prune

Note: if you’re changing something like CSS, you might need to rebuild the container with no cache. The docker rebuid process is iterative and might not ‘notice’ that a particular file needs to be updated:

docker build -t dbay . --no-cache

to see the console outputs of the container (including outputs from python’s print())

  1. get the container id:
docker ps
  1. view the logs in real time
docker logs -f <container_id>

Graph View

Backlinks