My question: I don't see the option in settings to add your own app SparkBox AI replied: I don’t have that documented, so I won’t guess where it appears in your dashboard. You can add a custom app over SSH instead, but you’ll need InfiniDysk’s Docker Compose file first: bash sudo sparkbox custom add /path/to/compose.yml --id infinidysk sudo sparkbox enable infinidysk sudo sparkbox up infinidysk Custom apps are supported in SparkBox v1.6.749 and later. Check your version with sparkbox --version. If you’re on an older version or the dashboard option is missing on a newer one, click Share to demox so Tom can check what’s happening. What I still need help with: (describe what didn't work or what's still broken) Hello I'm a newbie to all this and I need help. I don't see an option to add your own app and I'm trying to add "infinidysk". The AI told me it was possible to add your own app but lacked the documentation to aid me. Can you tell me if its possible and if so how do I add it and the folder structure to sparkbox container?
19 replies
Chris wrote:
You don’t need to start another conversation—you can continue here, and you haven’t done anything wrong. SparkBox asks you to re-enter your dashboard admin password before it adds a custom app. Enter it only in SparkBox’s password prompt, not in this public thread, then continue with the form. If it rejects the password or keeps prompting, stop there and tell me which of those happened; don’t post the password.
Chris wrote:
Sorry—the earlier AI answer sent you to SSH and made it sound as though the dashboard option did not exist; that was wrong. On SparkBox 1.6.749 or newer, open Settings → Your box → Add your own app and paste in InfiniDysk’s Docker Compose file. SparkBox saves the app on the host under your install folder’s custom/infinidysk/ directory (normally /opt/sparkbox/custom/infinidysk/), with its compose file and app data there—not inside the dashboard container. First, please check whether Add your own app is shown under Settings → Your box. If it is missing, tell me the SparkBox version you’re running and I’ll guide you from there. I’ve corrected what the assistant knows about this so it won’t send the next person down that route.
Bigmayes wrote:
SparkBox v1.6.776
Chris wrote:
Thanks—that confirms you're on a version where custom apps are supported. In Settings, open Your box and expand Add your own app; it needs the full Docker Compose file for InfiniDysk, not just its name. SparkBox keeps the app on the host under your install folder's custom/infinidysk/ directory (usually /opt/sparkbox/custom/infinidysk/), not inside the dashboard container; files such as its config/data go beside the compose file. The Settings page also shows your box's actual paths. Do you see the Your box section but not the add-app form, or is the whole section missing?
Bigmayes wrote:
I maybe overlooking it but I don't dont see the Your box setting under general or any of the other ones
Chris wrote:
I’m sorry—I sent you looking for “Your box” in the wrong dashboard. That section is available in the Classic dashboard; the newer V2/V3 settings do not currently include the custom-app editor. On the dashboard you’re looking at now, do you see a “Classic dashboard” link near the top? If so, click it once and tell me whether “Your box” appears in Settings; please don’t run commands or change anything. I’ve corrected what I know so the next person isn’t sent to look for that setting in V2/V3.
Bigmayes wrote:
ok, I see it
Bigmayes wrote:
What do I put for id?
Chris wrote:
Use infinidysk as the ID—lowercase, with no spaces. It’s a simple unique label based on the app’s name. If the form’s ID field shows a different requirement or an error, tell me the wording and I’ll help with that next.
Bigmayes wrote:
Can you tell me what else I should change in order for it to work within sparkbox? services: nzbdav: image: ghcr.io/infinidysk/infinidysk:latest containername: nzbdav restart: unless-stopped healthcheck: test: ["CMD-SHELL", "curl -fsSL http://localhost:3000/healthz /dev/null || exit 1"] interval: 30s retries: 3 startperiod: 60s timeout: 5s ports: - "3000:3000" environment: PUID: "1000" PGID: "1000" TZ: America/Chicago volumes: - ./config:/config - /mnt:/mnt
Chris wrote:
Thanks for posting the compose file. For SparkBox, add an x-sparkbox header with id: infinidysk, plus a title and one-line description, and change containername from nzbdav to sb-infinidysk (SparkBox requires custom container names to start with sb-). One important conflict: host port 3000 is already used by SparkBox's Homepage, so change the left side of 3000:3000 to a host port that is not already in use; keep the right side 3000 for the app. The health check can stay on the container's localhost:3000. The custom app's compose file belongs in the host's custom/infinidysk/ folder, with a config/ folder beside it for your ./config:/config mapping; it is stored on the host, not inside the dashboard container. I would not mount all of /mnt into the app unless it truly needs access to everything there—if it needs a particular folder, use that specific folder instead. The posted compose alone does not tell me which host folder InfiniDysk needs, so please check its own setup instructions before adding another mount. After those edits, use the add-app form's check and stop if it reports a problem; please don't paste secrets or the full config publicly.
Bigmayes wrote:
To be honest I have no clue of how to set this file up or where to start for that matter. Sorry for wasting your time
Chris wrote:
You’re not wasting my time—sorry, I gave you a lot of unfamiliar setup details at once. You already have the compose text; you don’t need to figure out the folder structure before we start. Let’s do just one check: in the Classic dashboard’s “Add your own app” form, what field labels do you see? Please don’t change or paste anything yet; just list the labels, or tell me if you haven’t opened the form.
Bigmayes wrote:
All I see is where you put the ID and paste the yaml file if thats what your talking about
Chris wrote:
Yes, that's the right form. Keep infinidysk in the ID field and paste the complete Docker Compose YAML you shared into the YAML box. You don't need to create the folders yourself. For now, just run the form's check and stop before saving or installing; tell me the exact message it shows so I can guide the next step without guessing.
Bigmayes wrote:
It keeps asking me to : Re-enter your admin password to continue. This action requires a recent reauthentication. Will I need to start another conversation about this cause I think I'm about to be blocked from sending messages
Bigmayes wrote:
Add an x-sparkbox: header with id, title and description (see docs/CUSTOM-APPS.md)
Bigmayes wrote:
I logged out and signed back in, it said: Add an x-sparkbox: header with id, title and description (see docs/CUSTOM-APPS.md)
Chris wrote:
That validation means the YAML is missing SparkBox’s metadata. Add a top-level x-sparkbox section with id: infinidysk, a title, and a short description, above services:; leave your existing service details in place. Then run the form’s check again and tell me the exact result. You do not need to share your password.