Being I don't have a Synology myself and I kind of hate the Synology GUI for the dockers, I'm doing this with the use of docker-compose.
Being I don't have a Synology myself and I kind of hate the Synology GUI for the dockers, I'm doing this with the use of docker-compose through a terminal.
This works like 10x faster then the GUI and after adding it shows up in the GUI.
This is faster then the GUI and after installing, it shows up in the Docker GUI.
Thnx to faxity for the initial compose that I used to create the Synology Guide.
We need to get some information that we need later to setup the docker-compose file.
## PUID and PGID
In order for the Docker container to access the shares on the Synology,
we need to give it the same permissions as your main user who has access to those shares.
For this we need to figure out the PUID and the PGID of the user having access to your shares.
## SSH
You will need to SSH into your Synology.
If you didn't already enable it you need to do that first
For this guide, we are mostly going to use the terminal. Some parts will need the Syno GUI.
To enable terminal, we need to enable SSH in the Synology Settings.
Name this shared folder `data`. You can disable the trash can. Click next until you are done.
## PUID and PGID
In order for the Docker container to access the shares on the Synology, we need to know the user ID (PUID) and group ID (PGUID).
For this, we are going to create a new user that only has access to the share(s) that we use for this guide.
Go to `Control Panel > User & Group`
In the `User` section, create a new user. Name it whatever you like, but for this guide we will use `docker`.
Fill out the rest of the information, generate a password and type your own.
Click next, you will now be able to select which group this user will belong to, it should only be `users`. Click next.
In the next screen you will be able to select to which Shares this user will have access to, click `No Access` on the top, this will deny all access.
Now only select Read/Write on the shares `docker` and `data`.
Click next until you reach `Assign application permissions`, deny all. Continue to click next until you are finished.
You have now created a new user. We are going to need this user's PUID/PGID.
Go into your terminal app, login to your synology ssh.
Once logged in type `id $user`. Change $user to the newly created username `docker`.
![!synology-id](images/synology-id.png)
Once logged in type `id`.
This will show your UID (aka PUID).
This will show you the UID (aka PUID).
Which in this screenshot is `1026` for the administrator
and the GID (aka PGID) which is `100` for the users group.
Remember these values for later use.
!!! note
Yes we know it's not recommended to use the admin account but if you already know this then you wouldn't need to read this ;)
It is not recommended to use your admin/main user account. That is why we just created a new user.
------
## Folder Structure
!!! attention
@ -52,7 +88,7 @@ For this example we're going to make use of a share called `data`.
On the host (Synology) you will need to add `/volume1/` before it. So `/volume1/data`
The `data` folder has sub-folders for `torrents` and `usenet` and each of these have sub-folders for `tv`, `movie` and `music` downloads to keep things neat. The `media` folder has nicely named `TV`, `Movies` and `Music` sub-folders, this is your library and what you’d pass to Plex, Emby or JellyFin.
The `data` folder has sub-folders for `torrents` and `usenet` and each of these have sub-folders for `tv`, `movie` and `music` downloads to keep things neat. The `library` folder has nicely named `tv`, `movies` and `music` sub-folders, this is your library and what you’d pass to Plex, Emby or JellyFin.