My custom repo

Dear all,

I’ve created a repo for several HA addons. Some of them have specific support threads (qBittorrent, Scrutiny, Addons updater) but for the others my idea was to use this thread (or github).

I’m doing this on top of my full time job so please star my repo if this is useful for you!

The addons are based around 3 key elements :

  • Implementation of mounting SMB shares
  • Faster update through automation
  • Based on linuxserver’s upstream images, that are very robust

There are three levels of quality for addons :

  • Premium : daily used & optimized
  • Normal : used regularly, without optimizations (base linuxserver’s options)
  • Base : tested at each version to install, but not run regularly

Shields explanation :

  • smb : allows accessing smb shares, or a local external disk (I try to avoid this as this means to have priviledge mode)
  • sql : requires an external sql database server
  • base : will be updated but not tested each time
  • privileged : requires protection mode off to run
  • support : specific HA thread


Adding this add-ons repository to your Home Assistant instance is
pretty easy. Follow the official instructions on the
website of Home Assistant, and use the following URL:

Available addons

Addons Updater support

Bazarr smb base

  • Companion application to Sonarr and Radarr to download subtitles
  • Based on Docker Hub



  • Code-server is VS Code running on a remote server, accessible through the browser.
  • Based on Docker Hub

Doublecommander smb

  • A free cross platform open source file manager with two panels side by side.
  • Based on Docker Hub

Emby smb

Filebrowser support


  • Inadyn, or In-a-Dyn, is a small and simple Dynamic DNS, DDNS, client with HTTPS support. Commonly available in many GNU/Linux distributions, used in off the shelf routers and Internet gateways to automate the task of keeping your Internet name in sync with your public¹ IP address. It can also be used in installations with redundant (backup) connections to the Internet.
  • Based on Docker Hub

Jackett smb base

  • Translates queries from apps (Sonarr, SickRage, CouchPotato, Mylar, etc) into tracker-site-specific http queries, parses the html response, then sends results back to the requesting software
  • Based on Docker Hub

Jellyfin smb

  • A Free Software Media System that puts you in control of managing and streaming your media.
  • Based on Docker Hub

Joal ingress

  • An open source command line RatioMaster with WebUI.

Nextcloud OCR smb


  • An HTPC/Homelab services organizer that is written in PHP
  • Based on Docker Hub

Papermerge smb

  • Open source document management system (DMS)
  • Based on Docker Hub

Portainer privileged ingress

Piwigo smb sql base

  • Piwigo is a photo gallery software for the web
  • Based on Docker Hub

Plex smb

  • Plex organizes video, music and photos from personal media libraries and streams them to smart TVs, streaming boxes and mobile devices.
  • Based on Docker Hub

Prowlarr smb base

  • Torrent Trackers and Usenet Indexers offering complete management ofSonarr, Radarr, Lidarr, and Readarr indexers with no per app setup required
  • Based on Docker Hub

Qbittorrent smb support ingress

Radarr smb base

  • A fork of Sonarr to work with movies like Couchpotato
  • Based on Docker Hub

Sonarr smb base

  • Can monitor multiple RSS feeds for new episodes of your favorite shows and will grab, sort and rename them.
  • Based on Docker Hub

Scrutiny support ingress

Transmission smb

Ubooquity smb support


I’ve had your repo for a little while for some reason.
Thank you first of all.
Secondly, the addons updater, does that only update your add-ons or will it update HA ones as well? Sometimes I want to give those a little time to settle out…

1 Like

Thanks very much!

Actually the addon updater does not touch the addons in HA. What is does is update the github repo, so that it is always aligned with the upstream versions - it is therefore only useful if you develop your own addons.
What I mean is that my addons are often a wrapper around pre-existing docker images made by linuxserver. When they publish a new version, the “update addon” updates my github repo so it is also updated. Hope it makes sense :wink: here is a screenshot showing the addon in action as the saying goes : “a picture can be clearer than 1000 words, especially by a non native English speaker”

It does.
Thanks for the clarification.
I’ve been looking to move some of these containers from a remote server to locally hosted, so this will be useful.

1 Like

Question for you.
I’ve been contemplating reformatting my Mac Mini to have HA OS running directly on it.
These Add-Ons make me think you run Plex in HAOS.
Do you have any issue mounting USB Drives or getting Plex to see an external NAS?
I would need to do both.

Thanks, sorry if I’ve misread your situation.

Hi ! Actually it was one of my main driver for creating the repo - being able to mount smb shares directly in the addons. I use Emby myself (plex clone) very well from HassOs.

On my rpi3b+ I have therefore my Emby server, which distributes the content from smb shares to clients

Honestly rather than reformatting you could have a specific partition to run it ; and keep your mac files until you do the switch. I don’t know MacOS architecture but I guess that should be feasible

Oh awesome, is that Double commander that lets you mount that stuff easier?

Another great thought, although I have a dinky 256Gb SSD for the main HDD.
I guess I could maybe use GParted or something after I’m satisfied.

1 Like

Indeed you could set aside 32Go to begin with, then see if you like what you see…

Doublecommander is nice but it is only a file explorer (alternative to my filebrowser addon)

For smb mounts, actually it’s done via the addons options. You need to define the smb share location (ex : //, and smb username & password, then it is mounted to /mnt/SHARENAME

oh I see.
And can you have a comma separated list I have two.

yes exactly, it’s available:-) as long as you have the same username/password

Here is an example from qbittorrent Home Assistant addon : qbittorrent (supports openvpn & smb mounts) - #31 by Milenco - Home Assistant OS - Home Assistant Community (

networkdisks: "//SERVER/SHARE,//SERVER/SHARE2" # optional, list of smb servers to mount, separated by commas
cifsusername: "username" # optional, smb username, same for all smb shares
cifspassword: "password" # optional, smb password
cifsdomain: "domain" # optional, allow setting the domain for the smb share
password, same for all smb shares
1 Like

I’ll look into this this weekend!

1 Like

Addition of new addon : portainer

Forked from hassio-addons/addon-portainer
Changes :

  • upgraded from 1.24 to 2.1.1
  • webui
  • ingress with nginx
  • ssl
  • password setting

So just a tip-toe into the water.
I added my NAS to the config, and I see it’s name under mnt but there’s no contents.
The logs don’t seem to indicate any failures.
Any troubleshooting tips?

Congrats on the first step :wink:
Which addon is that, qbittorrent ? A specificity of HA os is that the mount is specific to an addon, so won’t be accessible from other addons, even from the host.
No error message on the addon log? I guess the share is named “//IP/ShareNAS”
If you see no content perhaps it is an uid issue, is it set to 0/0 in the addon options?

It’s plex.
Yes, I’m ignorant to PUID and PGID.
I know that’s a thing in docker, I just don’t know what they mean.
Do I need to go into Portainer and look these up?

Nono, it’s just a reference to your user id and group id. You can set it up in the addon options in case your shared drive only provides access to your files for people with a specific user id. This is improbable though. You’re sure that there is no error message with “exit 1” in your addon log?

chown: cannot access '/config/plex/Library': No such file or directory
chown: cannot access '/config/plex/*': No such file or directory
[cont-init.d] 40-chown-files: exited 1.

I suppose it was not a glaring red error.
Some things are green like:

[16:12:08] INFO: Mounting external hdd...

So my eyes didn’t gravitate towards it.
Not sure how Supervisor’s log color scheme works.

But yea now special permissions for my NAS.
It is smbv1, but I checked that nice feature for people who don’t want to replace perfectly good hardware that’s internal to your network.

oh maybe I just wasn’t patient enough.
Now I’ve got some red glaring errors.

[16:13:43] FATAL: Unable to mount //<IP>/ShareNAS to /mnt/ShareNAS with username <USERNAME>, <PASSWORD>. Please check your remote share path, username, password, domain, try putting 0 in UID and GID
[16:13:43] FATAL: Error read : mount error(2): No such file or directory
Refer to the mount.cifs(8) manual page (e.g. man mount.cifs) and kernel log messages (dmesg)
1 Like

Mmh… Now that’s a good news :slight_smile: seeing an error is the first step toward resolution. Are you sure about your path? Including the case?

The errors for chown are not really important since the files probably don’t exist if you haven’t completed the config due to the smb not available.