scrutiny/docs/TROUBLESHOOTING_DOCKER.md

# Docker Images `master-omnibus` vs `latest`

> TL;DR; The `master-omnibus` and `latest` tags are almost semantically identical, as I follow a `golden master` 
development process. However if you want to ensure you're only using the latest release, you can change to `latest`

The CI script used to orchestrate the docker image builds can be found here: https://github.com/AnalogJ/scrutiny/blob/master/.github/workflows/docker-build.yaml#L166-L184

In general Scrutiny follows a `golden master` development process, which means that the `master` branch is not directly updated (unless its for documentation changes), 
instead development is done in a feature branch, or committed to the `beta` branch. 

As development progresses, and we're satisfied that a feature is complete, and the quality is acceptable, 
I merge the changes to `master` and trigger the creation of a new release -- ie, when master is updated, a new release
is almost immediately created (and tagged with `latest`)

So changing from `master-omnibus -> latest` will be the same thing for all intents and purposes. 

> NOTE: Previously, there was a `automated cron build` that ran on the `master` and `beta` branches. 
They used to trigger a `nightly` build, even if nothing has changed on the branch. This has a couple of benefits, but one is to 
ensure that there's no broken external dependencies in our (unchanged) code. This `nightly` build no longer updates the `master-omnibus` tag. 

# Running Docker `rootless`

To avoid that the container(s) restart when you installed Docker as `rootless` you need to isssue the following commands to allow the session to stay alive even after you close your (SSH) sesssion:

`sudo loginctl enable-linger $(whoami)`

`systemctl --user enable docker`