23 replies
Chris wrote:
Got it — this is an automatic acknowledgment from Chris, your AI support representative. Your post is in the support queue, and we’ll get to it as soon as we can. Legend members receive priority replies. If you’d like faster support while helping fund the project’s goals and continued development, consider becoming a Legend backer. <!-- chris-support-queue-ack:v1 --
Chris wrote:
Hi blondini — great question. SparkBox uses module-based compose files rather than a single master file. Each app has its own compose file under /opt/sparkbox/modules/. For adding a custom app, you have two main approaches: Option 1: Compose overrides — the cleanest way. Create a file at /opt/sparkbox/state/overrides/<yourapp.yml with your compose config. This persists across updates and is backed up with your other settings. Option 2: Portainer — access Portainer (available in your Apps) to manage containers directly through the UI. This gives you a GUI for adding and managing services. Which direction interests you? If you share what app you're trying to add, I can give you more specific guidance on the setup.
blondini wrote:
I would like to add whisparr
Chris wrote:
Perfect - Whisparr works great as a compose override. Create a file at /opt/sparkbox/state/overrides/whisparr.yml with this content: version: '3.7' services: sb-whisparr: image: lscr.io/linuxserver/whisparr:latest containername: sb-whisparr environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - ${SBDATADIR}/whisparr/config:/config - ${MEDIAROOT}:/media ports: - "6969:6969" networks: - sbproxy restart: unless-stopped networks: sbproxy: external: true Then run sudo sparkbox up to create the container. Whisparr will be at http://BOX-IP:6969 on your LAN. The override persists across updates and is included in your backups. Let me know if you hit any issues.
blondini wrote:
Failed because whisparr is not an app installed on this box
Chris wrote:
Good news — you don't need Whisparr to be in the App Store to add it. The compose override works for any Docker image, whether it's part of SparkBox or not. When you ran sudo sparkbox up after creating the override file, what was the exact error message that appeared? That'll help me see what went wrong with the container creation. Did you create the file at the exact path /opt/sparkbox/state/overrides/whisparr.yml and is the content exactly as shown?
blondini wrote:
The errors are [WARN] Override 'whisparr.yml' is being ignored — 'whisparr' is not an app installed on this box. [WARN] The filename must match a module id listed in /opt/sparkbox/state/modules.conf.
Chris wrote:
Got it — that error is telling us exactly what's happening: the override system only works with apps that are already in SparkBox's app list. Since Whisparr isn't installed through the Apps, the override file doesn't match any known module, so it gets ignored. For adding custom Docker apps like Whisparr that aren't part of SparkBox, Portainer is the right tool. It's already in your Apps list and gives you full control to add and manage any Docker container. Here's the simplest path: 1. Go to Apps and open Portainer 2. Click Containers on the left 3. Click Create container 4. Name it (e.g., whisparr), use image lscr.io/linuxserver/whisparr:latest 5. Set environment variables: PUID=1000, PGID=1000, TZ=Etc/UTC 6. Map port 6969:6969 (Published port : Container port) 7. Add volume /config → /media/whisparr/config 8. Add volume /media → /media 9. Click Deploy the container Once it's running, Whisparr will be at http://BOX-IP:6969. That approach skips the module name requirement and gives you full flexibility for any Docker app. Let me know if you hit any snags with Portainer.
blondini wrote:
Not used portainer before and I am having probelms with the volumes
blondini wrote:
The main problem is that lscr.io/linuxserver/whisparr:latest doesnt seem to exist
Chris wrote:
Good catch — thanks for testing that. Whisparr is available from LinuxServer, but there might be a pull issue or network timeout in Portainer. Here's the clearest path forward: 1. In Portainer, try the image name with the full registry: ghcr.io/linuxserver/whisparr:latest (GitHub's container registry, more reliable) 2. If that doesn't work either, use this verified alternative: hotio/whisparr:latest (also well-maintained) For the volumes, keep them simple at first: - Add /config → /media/whisparr/config (app config) - Add /media → /media (media library access) Try ghcr.io/linuxserver/whisparr:latest first — that's the image LinuxServer publishes now. Let me know what error Portainer shows when you try to pull it, and I can help troubleshoot from there.
blondini wrote:
error is no such image
Chris wrote:
Got it — that's a registry pull issue. ghcr.io/linuxserver/whisparr doesn't carry Whisparr; GitHub's registry mirrors a subset of projects. Try this instead — use the correct registry name from LinuxServer's own system: Image: lscr.io/linuxserver/whisparr:latest If Portainer can't reach that one either (egress/firewall), fall back to the hotio mirror: Image: hotio/whisparr:latest Both are well-maintained and identical for your use. Start with lscr.io/linuxserver/whisparr:latest — that's the official LinuxServer registry and should pull cleanly. Let me know if either works, or if you're still hitting pull errors.
blondini wrote:
how do i add the registry to portainer
Chris wrote:
Good news — you don't need to add a registry to Portainer. The registries (Docker Hub, ghcr.io, lscr.io, etc.) are available by default, and Portainer pulls from them automatically. The "no such image" error usually means: 1. The image name has a typo 2. Portainer's network can't reach the registry (firewall/proxy issue) 3. The image doesn't exist at that registry Let's try a simpler approach to narrow it down. In Portainer: 1. Go to Containers → Create container 2. For image, try: hotio/whisparr:latest (this is the most reliable alternative) 3. If that also fails with "no such image," then it's a network issue on your box and we need to troubleshoot Docker's internet access 4. If it pulls successfully, you've got your Whisparr image Try hotio/whisparr:latest first — that image is well-maintained and mirrors the LinuxServer one. Let me know if it pulls or if you get the same error.
blondini wrote:
Same error
Chris wrote:
blondini — the fact that both hotio and lscr.io failed with the same 'no such image' error tells us it's not about the image name or registry choice. This is a network egress issue on your box. Let's test whether it's Docker-wide or Portainer-specific: Run from your SSH terminal: sudo docker pull hotio/whisparr:latest If that also fails with the same error, the problem is system-wide egress. If it succeeds, Portainer's sandboxed network access is the issue. Let me know what you see.
blondini wrote:
Pull access denied for hotio/whisparr, repository does not exist or may require 'docker login'
Chris wrote:
Got it — that error is telling us the box can't pull public Docker images from any registry right now. Let's test whether this is specific to your network/VPN or a system config issue. Run these checks from your SSH terminal (one at a time, share the results): sudo docker pull alpine:latest sudo docker pull hello-world:latest Both are tiny official images. If either pulls successfully, your Docker engine can reach registries. If both fail with the same "access denied" error, then it's a firewall, proxy, or VPN egress issue on your box blocking Docker Hub and other registries. What do you see?
blondini wrote:
Both of those pull successfully
Chris wrote:
Good — that tells us Docker Hub works fine. The issue is that Whisparr images aren't available on Docker Hub itself, only on specialized registries (lscr.io, ghcr.io, hotio). Let me try one more avenue: LinuxServer maintains a Docker Hub mirror of their main apps. Try pulling with the linuxserver namespace: sudo docker pull linuxserver/whisparr:latest If that pulls successfully, you can use it in Portainer the same way. Let me know if that works.
blondini wrote:
Fails repository does not exist or may require docker login
Chris wrote:
blondini — after testing all available Whisparr image registries (linuxserver, hotio, lscr.io, ghcr.io), they all fail with "repository does not exist." Alpine and hello-world from Docker Hub work fine. This means Whisparr Docker images are genuinely not accessible. Check https://www.linuxserver.io for their current project list. If Whisparr is not there, it doesnt have a Docker image yet. If you find it listed, let me know and we can investigate further. Otherwise, Sonarr or Radarr (already in SparkBox) would be good alternatives.