Reference
App plug-ins
An app plug-in runs a whole app made by others, such as Seerr or Kavita, in Starboard's locked-down containers, with its own web page on your home network. Eleven plug-ins here are app plug-ins.
When would you use it
- You want to add an app to the collection rather than to Starboard's main install.
- You need to know what Starboard allows an app to do.
What makes one
network:portand a container with"publish": trueon thelannetwork: Starboard chooses a free port on the home network, tryinghost_portfirst, and shows the address with Open.- Its folders at the paths the app expects, such as
data:/config, and media folders read only where it only reads, such asmedia/books:ro. tmpfsfor folders the app writes to in memory, andpidsfor apps with many threads.adopt, to copy an app the main install already runs into the plug-in, as Tdarr does.- Higher limits than a card plug-in: up to 2048 MB and 4 cores a container with
network:port. - A small helper first in
containers, when Starboard should show a card or set the app up, as Themearr and Checkrr have. It can run in the official Python image with no image of ours: its code goes in the manifest'sfiles, which Starboard writes once into its folder, andcommandruns it. Put the version in the file's name, such asapp-1.0.0.py, so an update writes the new one.tools/make_app_helpers.pycopies itshelper.pyinto the manifest.
Rules
- The image is the app's own, pinned by digest. Every app runs read only, as a user that is not root, with no extra rights, like every plug-in.
- Measure it at rest with
tools/app_check.py, which runs it as Starboard writes it, on closed networks, and put the figures in its README. - Say in its help that its own web page was not checked for accessibility by Starboard.
- Removing it keeps its data: in
data/plugins/.removed, or the holding folder.
The app plug-ins here
Jellystat, Navidrome, Kavita, Calibre-Web, Wizarr, Maintainerr, Uptime Kuma, Seerr, Tdarr, Themearr and Checkrr. Each one's For developers page lists its containers and folders, such as Tdarr's.
Find out more
This page on GitHub, where the help is written.