From 4ba941e09dc0a35f16d514551299e9dd53006378 Mon Sep 17 00:00:00 2001 From: Pysis Date: Wed, 25 Oct 2023 14:41:06 -0400 Subject: [PATCH] Update docker.md Added section and link for Debian. Tested basic initialization. Added Fedora link. Removed some redundancies there. --- docs/installation/docker.md | 34 +++++++++++++++++++++------------- 1 file changed, 21 insertions(+), 13 deletions(-) diff --git a/docs/installation/docker.md b/docs/installation/docker.md index 195506117..ba2d3ca91 100644 --- a/docs/installation/docker.md +++ b/docs/installation/docker.md @@ -1,21 +1,28 @@ # Docker -Some of these steps may not apply to your installation. Understand what they do, and ignore or customize as necessary. +Some of these steps may not apply to your installation. Understand what they do, and ignore, or customize as necessary. -## Fedora Linux Preparation +## Preparation For operating system support and service packages. +### Debian Linux + +Install Docker (Engine): https://docs.docker.com/engine/install/debian/ + +### Fedora Linux + +Install Docker (Engine): https://docs.docker.com/engine/install/fedora/ + +#### Extra instructions + ``` -sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo; -sudo dnf install docker-ce; sudo usermod -a -G docker ; ``` Re-login or restart the machine. ``` -sudo systemctl start docker; sudo mkdir /srv/UMS; sudo chcon -t svirt_sandbox_file_t /srv/UMS; sudo chown core:docker /srv/UMS; @@ -26,14 +33,15 @@ Mount storage to host and link into that directory, probably read-only. ## Container Setup -Mount following volumes and ports: -- Media folder VOLUME /media -- Profile folder containing UMS.conf VOLUME /profile +Mount the following volumes: +- Media folder `/media` +- Profile folder containing UMS.conf `/profile` Expose/forward these ports from the host: 1044, 5001, 9001. -The following scripts does those steps: +The following scripts accomplish that (using the fish shell): ``` +sudo su -; set rootDir "/home/UMS/.config/UMS"; mkdir -p "$rootDir/data"; ​ @@ -77,11 +85,11 @@ docker cp :/var/log/UMS/root/debug.log ./; Using Fedora CoreOS, I had access/permission denied problems trying to use bind mounts. -It may be recommended to use the Docker-managed, named-volumes capability instead, but to avoid that complexity, I found that the additional :Z as a suffix to the bind mount's descriptor option value allowed container write access to host files. -:z can also be used instead, but security advice may suggest keeping resources more isolated between application/service environments, rather than shared. +It may be recommended to use the Docker-managed, named-volumes capability instead, but to avoid that complexity, I found that the additional `:Z` as a suffix to the bind mount's descriptor option value allowed container write access to host files. +`:z` can also be used instead, but security advice may suggest keeping resources more isolated between application/service environments, rather than shared. Matching error messages can be seen using journalctl, so it is an SELinux problem. -The solution for that would be to run chcon -Rt svirt_sandbox_file_t host_dir, but that also seems discouraged. +The solution for that would be to run `chcon -Rt svirt_sandbox_file_t` host_dir, but that also seems discouraged. Strangely this is not an issue on Fedora Workstation, but I guess installing it manually added a package to deal with this. Seems to be container-selinux. @@ -103,4 +111,4 @@ Strangely this is not an issue on Fedora Workstation, but I guess installing it - https://github.com/UniversalMediaServer/UniversalMediaServer/blob/master/docker/Dockerfile - https://github.com/UniversalMediaServer/UniversalMediaServer/tree/master/src/main/external-resources - https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label -- https://drive.google.com/file/d/1ORNc113a8is1K1ZZtp1r3iz44uzJDeRp/view \ No newline at end of file +- https://drive.google.com/file/d/1ORNc113a8is1K1ZZtp1r3iz44uzJDeRp/view