Skip to content

Commit f9fbd7a

Browse files
authored
Merge pull request #383 from DialmasterOrg/docs/unraid
docs(unraid): add instructions for running as non-root user
2 parents 2048bba + 276febc commit f9fbd7a

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

docs/platforms/unraid.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,3 +53,35 @@ curl -L https://raw.githubusercontent.com/DialmasterOrg/unraid-templates/main/Yo
5353
Once the container is running, open http://<your-unraid-ip>:3087 in your browser to access Youtarr.
5454

5555
- **Note** Until the template is accepted into the main Community Applications feed, it is available directly from the repository above.
56+
57+
## Running as Non-Root User
58+
59+
By default, Youtarr runs as root inside the container. This works fine for most setups, but if you need Plex or Jellyfin to be able to delete files that Youtarr downloads, you'll need to run Youtarr as a non-root user with matching permissions.
60+
61+
**Note**: The `YOUTARR_UID` and `YOUTARR_GID` environment variables do not work on Unraid. You must use the `--user` parameter instead.
62+
63+
### Steps to Run as Non-Root
64+
65+
1. **Stop the Youtarr container** if it's running
66+
67+
2. **Set correct ownership on your directories** by opening an Unraid terminal and running:
68+
```bash
69+
chown -R 99:100 /mnt/user/appdata/youtarr/config
70+
chown -R 99:100 /mnt/user/appdata/youtarr/jobs
71+
chown -R 99:100 /path/to/your/youtube_videos
72+
```
73+
Replace the paths with your actual mapped directories. The `99:100` corresponds to the `nobody:users` user/group on Unraid.
74+
75+
3. **Add the user parameter to your container**:
76+
- Edit your Youtarr container in Unraid
77+
- Scroll down to "Extra Parameters"
78+
- Add: `--user 99:100`
79+
- Click "Apply" to restart the container
80+
81+
4. **Verify it's working** by running:
82+
```bash
83+
docker exec -it Youtarr sh -c 'id'
84+
```
85+
You should see `uid=99(nobody) gid=100(users)` instead of `uid=0(root)`.
86+
87+
After this setup, Youtarr will create files with `nobody:users` ownership, which matches the default permissions that Plex and other media apps use on Unraid, allowing them to delete files as needed.

0 commit comments

Comments
 (0)