Add App button

[Maximus1]

German first, English at the bottom

Heimdall: „App hinzufügen"-Button via Portainer

Ziel

Ein dauerhafter Floating-Button (unten rechts), der direkt das Formular zum Hinzufügen einer neuen App oder Webseite öffnet – auch nach Container-Updates.

---

Voraussetzungen

• Heimdall läuft als Docker-Container
• Verwaltung über Portainer (Stack oder einzelner Container)
• SSH-Zugang zum Host-System

---

Schritt 1: Init-Skript erstellen

Per SSH auf dem Host-System ausführen:

mkdir -p /config/custom-cont-init.d

Hinweis: /config entspricht dem tatsächlichen Host-Pfad des gemounteten Config-Volumes.
Den echten Pfad ermitteln mit:

docker inspect heimdall --format '{{ range .Mounts }}{{ .Source }}{{ end }}'

Skript anlegen:

cat > /config/custom-cont-init.d/add-button.sh << 'EOF'
#!/bin/bash
FILE="/app/www/resources/views/layouts/app.blade.php"
if ! grep -q "items/create" "$FILE"; then
  sed -i 's|</body>|<a href="/items/create" style="position:fixed;bottom:30px;right:30px;width:56px;height:56px;border-radius:50%;background:rgba(255,255,255,0.15);backdrop-filter:blur(10px);border:1px solid rgba(255,255,255,0.3);display:flex;align-items:center;justify-content:center;font-size:28px;color:white;text-decoration:none;box-shadow:0 4px 20px rgba(0,0,0,0.3);z-index:9999;" title="App hinzufügen">+</a></body>|' "$FILE"
fi
EOF
 
chmod +x /config/custom-cont-init.d/add-button.sh

Das if-Statement verhindert, dass der Button bei jedem Neustart doppelt eingefügt wird.

---

Schritt 2: Volume-Mount in Portainer eintragen

Im Portainer Stack-Editor das Volume für custom-cont-init.d ergänzen:

volumes:
  - /config:/config
  - /config/custom-cont-init.d:/custom-cont-init.d

Wichtig: linuxserver.io erwartet das Verzeichnis unter /custom-cont-init.d im Container-Root – nicht unter /config/custom-cont-init.d.
Beide Einträge sind erforderlich.

---

Schritt 3: Stack aktualisieren und prüfen

In Portainer: Update the stack bzw. Container neu starten, dann prüfen:

docker logs heimdall 2>&1 | grep -i custom

Erwartete Ausgabe:

[custom-init] add-button.sh: executing...

---

Ergebnis

Ein halbtransparenter „+"-Button erscheint dauerhaft unten rechts auf dem Dashboard und öffnet direkt /items/create.

Bei jedem Container-Update (neues Image) wird das Skript automatisch erneut ausgeführt und der Button wieder eingefügt.

---

Troubleshooting

Problem	Ursache	Lösung
No custom files found	Falscher Mount-Pfad	Sicherstellen dass /custom-cont-init.d direkt gemountet ist
Button nicht sichtbar	Skript wurde nicht ausgeführt	Manuell testen: docker exec heimdall bash /config/custom-cont-init.d/add-button.sh
Button zeigt auf falsche URL	Falsche Route im Skript	Route auf /items/create prüfen
Container startet nicht	Fehlerhafter File-Bind-Mount	Nur Verzeichnisse mounten, keine einzelnen Dateien

Heimdall: "Add Application" Button via Portainer

Goal

A persistent floating button (bottom right) that directly opens the form for adding a new app or website – surviving container updates.

---

Prerequisites

• Heimdall running as a Docker container
• Managed via Portainer (stack or standalone container)
• SSH access to the host system

---

Step 1: Create the Init Script

Run the following on the host system via SSH:

mkdir -p /config/custom-cont-init.d

Note: /config refers to the actual host path of the mounted config volume.
To find the real path, run:

docker inspect heimdall --format '{{ range .Mounts }}{{ .Source }}{{ end }}'

Create the script:

cat > /config/custom-cont-init.d/add-button.sh << 'EOF'
#!/bin/bash
FILE="/app/www/resources/views/layouts/app.blade.php"
if ! grep -q "items/create" "$FILE"; then
  sed -i 's|</body>|<a href="/items/create" style="position:fixed;bottom:30px;right:30px;width:56px;height:56px;border-radius:50%;background:rgba(255,255,255,0.15);backdrop-filter:blur(10px);border:1px solid rgba(255,255,255,0.3);display:flex;align-items:center;justify-content:center;font-size:28px;color:white;text-decoration:none;box-shadow:0 4px 20px rgba(0,0,0,0.3);z-index:9999;" title="Add application">+</a></body>|' "$FILE"
fi
EOF
 
chmod +x /config/custom-cont-init.d/add-button.sh

The if statement prevents the button from being inserted multiple times on each restart.

---

Step 2: Add Volume Mount in Portainer

In the Portainer stack editor, add the volume for custom-cont-init.d:

volumes:
  - /config:/config
  - /config/custom-cont-init.d:/custom-cont-init.d

Important: linuxserver.io expects the directory at /custom-cont-init.d in the container root – not under /config/custom-cont-init.d.
Both entries are required.

---

Step 3: Update the Stack and Verify

In Portainer: click Update the stack or restart the container, then verify:

docker logs heimdall 2>&1 | grep -i custom

Expected output:

[custom-init] add-button.sh: executing...

---

Result

A semi-transparent "+" button appears persistently in the bottom right corner of the dashboard and directly opens /items/create.

Every time the container is updated (new image), the script runs automatically and re-inserts the button.

---

Troubleshooting

Problem	Cause	Solution
No custom files found	Wrong mount path	Ensure /custom-cont-init.d is mounted directly in the container root
Button not visible	Script was not executed	Test manually: docker exec heimdall bash /config/custom-cont-init.d/add-button.sh
Button points to wrong URL	Wrong route in script	Verify route is set to /items/create
Container won't start	Incorrect file bind mount	Only mount directories, never individual files