Docker Configuration via Synology Docker GUI

[Carlton Bale]

I installed the SageTV Java 10 Docker on my Synology NAS. Docker is configured via a GUI and I want to make sure I'm implementing the original instruction correctly. Feedback appreciated.

Original instructions I'm following:

docker run -d --name sagetv-server \
  -v /home/seans/unRAID/mnt/user/sagemedia:/var/media \
  -v /home/seans/unRAID/mnt/user/mediaext:/var/mediaext \
  -v /home/seans/unRAID/mnt/user/apps/sagetv3:/opt/sagetv \
  -v /home/seans/unRAID:/unraid \
  --net host \
  --env PUID=1000 \
  --env PGID=1000 \
  --env VIDEO_GUID=19 \
  --env OPT_GENTUNER=Y \
  --env OPT_COMMANDIR=Y \
  --env OPT_COMSKIP=Y \
  --env JAVA_MEM_MB=768 \
  --env VERSION=latest \
  --env OPT_SETPERMS=Y \
  --privileged \
  -t -i stuckless/sagetv-server-java8

Here' the General Settings screen. Container Name takes care of: --name sagetv-server and high privilege takes care of --privileged \


The Volumes tab takes care of the -v ... commands:


Port settings are auto, taking care of --net host \


Environment settings take care of the --env settings



Question: After removing all of the GUI-entered commands, the original run command distills down to this:

docker run -d -t -i docker/sagetv-server-java10

Is this correct? Do I need the the -d, -t, and -i arguments?

What's the purpose of the "docker/sagetv-server-java10" path? Do I need that?

Thanks in advance!

[stuckless]

I don't think your volumes are correct.

the -v commands map NAS volumns to CONTAINER volumes. (ie, path on your synology file system to path INSIDE the docker container)

  -v /home/seans/unRAID/mnt/user/sagemedia:/var/media \
  -v /home/seans/unRAID/mnt/user/mediaext:/var/mediaext \
  -v /home/seans/unRAID/mnt/user/apps/sagetv3:/opt/sagetv \
  -v /home/seans/unRAID:/unraid \

So in your case you are not using /var/media or /opt/sagetv and as such recordings and sagetv configurations will be stored INSIDE your container and restarts/upgrades will likely blow it all away.

So in your UI it would appear that your RIGHT HAND side must be values like /opt/sagetv and /var/media/ and the LEFT HAND side will be full paths to where you want this information stored on your NAS. And neither of them can be READ ONLY (sagetv will need to write to those paths)

The ENV section will need some tweaking as well

  --env PUID=1000 \
  --env PGID=1000 \
  --env VIDEO_GUID=19 \
  --env OPT_GENTUNER=Y \
  --env OPT_COMMANDIR=Y \
  --env OPT_COMSKIP=Y \
  --env JAVA_MEM_MB=768 \
  --env VERSION=latest \
  --env OPT_SETPERMS=Y \

PUID and GUID MUST be the linux user and group ON YOUR SYNOLOGY system under which sagetv will run. (on unRAID this is 99,100 respectively, on my personal linux system this is 1000,1000 respectively).

The VIDEO_GUID needs to be group id of the "video" group which generally has read access to the /dev/video# nodes.

SETPERMS if set to Y will change the ownership of all files under /var/media and /opt/sagetv (is your mounted paths) to be the PUID and PGUID so that when you access the files over smb or some other means, you actually have access to those files.

[Carlton Bale]

Thanks Stuckless. This helps tremendously. I now understand what the volume mount commands are doing and got everything in the container mapped.

For UIDs, my initial thought is that everything could go under root. SSH into the Synology system gives root UID/GID/Groups = 0 and and an existing docker container shows similar. Or should I run it under a specific user account?


For the Video_GUID, I'm completely lost. I can't find any reference to that in the Synology system for any user or group, and no reference for /dev/video#. There is no video output from the Synology; it's completely headless. I'm not sure what I need to do that Video_GUID, if anything. Thoughts?

[stuckless]

Originally Posted by Carlton Bale

Thanks Stuckless. This helps tremendously. I now understand what the volume mount commands are doing and got everything in the container mapped.

For UIDs, my initial thought is that everything could go under root. SSH into the Synology system gives root UID/GID/Groups = 0 and and an existing docker container shows similar. Or should I run it under a specific user account?


For the Video_GUID, I'm completely lost. I can't find any reference to that in the Synology system for any user or group, and no reference for /dev/video#. There is no video output from the Synology; it's completely headless. I'm not sure what I need to do that Video_GUID, if anything. Thoughts?

if you can ssh into your NAS, then you can figure out these UIDs like this..

$ cat /etc/group | grep video

It will show something like,

video:x:44:

so 44 is the video guid.

So the next would be to figure out is Synology is owning everything as root or not. So use the 'ls -al' command on some media file that you copied to your nas.

ie, when ssh'd to the your NAS if you have files in /media/videos/ (as an example), then
$ ls -al /media/videos
it will show complete username and group ownerships
-r--r--r-- 1 seans seans 828 Feb 15
if the user shows up as root root then yeah, synology runs as root and owns everything as root. But if it shows something else, that likely that is the user that the NAS is using for file ownerships, and you need to set the PUID and PGUID to their numeric user and group values.

$ cat /etc/passwd | grep seans
seans:x:1000:1000:Sean Stuckless,,,:/home/seans:/bin/bash

in the above case seans user has a user:group ids of 1000 and 1000.

[Carlton Bale]

Thanks for the tip on the "ls -al" command. It looks like the files are owned by the default admin account (1024) and the users account group (100).

Originally Posted by stuckless

if you can ssh into your NAS, then you can figure out these UIDs like this..

$ cat /etc/group | grep video

It will show something like,

video:x:44:

so 44 is the video guid.

I previously tried something similar, and unfortunately, there is nothing in /etc/group for video. Here's the full list via "cat /etc/group", and nothing obviously links to video.

#$_@GID__INDEX@_$276949$
administrators:x:101:sysadmin
avahi:x:84:
bind:x:53:
daemon:x:2:daemon,root
dbus:x:81:
dovecot:x:143:dovecot
ftp:x:21:ftp
http:x:1023:user1
ldap:x:439:
log:x:19:root
lp:x:7:lp
maildrop:x:126:
mysql:x:66:
nobody:x:99:
ntp:x:87:
postfix:x:125:postfix
postgres:x:55:
root:x:0:
rpc:x:32:
smmsp:x:25:sysadmin,smmsp
StorageAnalyzer:x:276949:
SynoFinder:x:195341:
SynologyGuests:x:106:
system:x:1:system
users:x:100:
wheel:x:10:

I don't think I can just remove the video environment variable. It doesn't seem to launch, and I'm assuming that's the issue.

[stuckless]

So the video group only comes into play, later, if you are actually using video hardware. Based on your group list, you can probably set it to 1, and it won't be used until you add video hardware (and you don't add video hardware, then no worries either).

If sagetv is not starting up, then you'll want to check the docker logs to see if there is a problem.

How does synology start your docker container? Does it provide a log?