@simplehomelab/deployrr 6.0.0-rc3

package/apps/official/guacamole/compose.yml

@@ -0,0 +1,26 @@
+services:
+  # Guacamole - Remote desktop, SSH, VNC, Telnet on any HTML5 Browser
+  guacamole:
+    image: guacamole/guacamole:${GUACAMOLE_VERSION_PIN}
+    container_name: guacamole
+    security_opt:
+      - no-new-privileges:true
+    restart: unless-stopped
+    profiles: ["apps", "all"]
+    depends_on:
+      guacamole-mariadb:
+        condition: service_healthy
+      guacd:
+        condition: service_started
+    networks:
+      - default
+    ports:
+      - "$GUACAMOLE_PORT:8080"
+    environment:
+      GUACD_HOSTNAME: guacd
+      MYSQL_HOSTNAME: guacamole-mariadb
+      MYSQL_PORT: 3306
+      MYSQL_DATABASE: guacamole
+      MYSQL_USER: guacamole_db_user
+      MYSQL_PASSWORD: $GUACAMOLE_MARIADB_PASSWORD
+    # DOCKER-LABELS-PLACEHOLDER

package/apps/official/guacamole/guacamole-mariadb.yml

@@ -0,0 +1,26 @@
+services:
+  # Guacamole MariaDB - Dedicated Database for Guacamole
+  guacamole-mariadb:
+    container_name: guacamole-mariadb
+    image: mariadb:${GUACAMOLEMARIADB_VERSION_PIN}
+    security_opt:
+      - no-new-privileges:true
+    restart: unless-stopped
+    profiles: ["apps", "all"]
+    healthcheck:
+      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
+      start_period: 1m
+      start_interval: 10s
+      interval: 1m
+      timeout: 5s
+      retries: 3
+    networks:
+      - default
+    volumes:
+      - $DOCKERDIR/appdata/guacamole-mariadb:/var/lib/mysql
+    environment:
+      - MARIADB_ROOT_PASSWORD=$GUACAMOLE_MARIADB_ROOT_PASSWORD
+      - MARIADB_DATABASE=guacamole
+      - MARIADB_USER=guacamole_db_user
+      - MARIADB_PASSWORD=$GUACAMOLE_MARIADB_PASSWORD
+    # DOCKER-LABELS-PLACEHOLDER

package/apps/official/guacamole/guacd.yml

@@ -0,0 +1,12 @@
+services:
+  # Guacamole Daemon - Connection proxy for Guacamole
+  guacd:
+    image: guacamole/guacd:${GUACD_VERSION_PIN}
+    container_name: guacd
+    security_opt:
+      - no-new-privileges:true
+    restart: unless-stopped
+    profiles: ["apps", "all"]
+    networks:
+      - default
+    # DOCKER-LABELS-PLACEHOLDER

package/apps/official/guacamole/hooks/post-install.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# Guacamole post-install hook
+# Initializes the database schema using v5 style (dynamic SQL generation)
+
+APP_SNAME="guacamole"
+APP_PNAME="Guacamole"
+
+f_print_step "1/3" "Waiting for $APP_PNAME MariaDB to be ready..."
+f_print_substep "Ensuring database is fully initialized..."
+f_blank_line_sleep 5
+echo
+
+f_print_step "2/3" "Initializing $APP_PNAME database schema..."
+
+# Get database credentials (inherited from exported env vars set by _write_variable)
+GUACAMOLE_DB_USER="guacamole_db_user"
+GUACAMOLE_DB_PASSWORD="${GUACAMOLE_MARIADB_PASSWORD}"
+
+# Get version pin (inherited from exported env vars, fallback to latest)
+GUACAMOLE_VERSION_PIN="${GUACAMOLE_VERSION_PIN:-latest}"
+
+# Check if database is already initialized (check for guacamole_user table)
+DB_INITIALIZED=$(sudo docker exec guacamole-mariadb mariadb -u"$GUACAMOLE_DB_USER" -p"$GUACAMOLE_DB_PASSWORD" guacamole -e "SHOW TABLES LIKE 'guacamole_user';" 2>/dev/null | grep -c "guacamole_user" || true)
+
+if [[ "$DB_INITIALIZED" -gt 0 ]]; then
+    f_print_substep "Database schema already initialized, skipping..."
+else
+    f_print_substep "Generating database schema from Guacamole image..."
+
+    # Generate the init SQL from the guacamole image (v5 style)
+    INIT_SQL_FILE="/tmp/guacamole_initdb.sql"
+    sudo docker run --rm guacamole/guacamole:${GUACAMOLE_VERSION_PIN} /opt/guacamole/bin/initdb.sh --mysql > "$INIT_SQL_FILE" 2>/dev/null
+
+    if [[ ! -s "$INIT_SQL_FILE" ]]; then
+        f_print_error "Failed to generate database schema"
+        rm -f "$INIT_SQL_FILE"
+        return 1
+    fi
+
+    f_print_substep "Applying schema to guacamole-mariadb..."
+
+    # Apply the schema to the database
+    sudo docker exec -i guacamole-mariadb mariadb -u"$GUACAMOLE_DB_USER" -p"$GUACAMOLE_DB_PASSWORD" guacamole < "$INIT_SQL_FILE" 2>/dev/null
+
+    if [[ $? -eq 0 ]]; then
+        f_print_substep "Database schema applied successfully"
+    else
+        f_print_warning "Database initialization may have had issues - check Guacamole logs"
+    fi
+
+    # Cleanup
+    rm -f "$INIT_SQL_FILE"
+fi
+
+echo
+
+f_print_step "3/3" "Restarting $APP_PNAME to connect to initialized database..."
+f_docker_compose_recreate "guacamole" "06"
+
+f_print_success "$APP_PNAME database initialization complete"

package/apps/official/guacamole/manifest.json

@@ -0,0 +1,131 @@
+{
+  "$schema": "../../../apps/manifest-schema.json",
+  "version": "1.2",
+
+  "app": {
+    "sname": "guacamole",
+    "pname": "Guacamole",
+    "description": "Apache Guacamole is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH. This installation uses a dedicated MariaDB database and the Guacamole daemon (guacd) for better isolation.",
+    "descriptionShort": "Remote SSH, VNC, Telnet, and RDP viewer",
+    "icon": "sh-guacamole",
+    "category": "official",
+    "menuNumber": "06",
+    "tags": ["remote-access", "vnc", "rdp", "ssh", "telnet", "web"]
+  },
+
+  "deployment": {
+    "type": "multicontainer",
+    "compose": "compose.yml",
+    "profiles": ["apps", "all"],
+    "networks": ["default"],
+    "webui": true,
+    "port": 8081,
+    "protocol": "http"
+  },
+
+  "dependencies": [
+    {
+      "sname": "guacamole-mariadb",
+      "pname": "Guacamole MariaDB",
+      "compose": "guacamole-mariadb.yml",
+      "installOrder": 1,
+      "waitForHealthy": true,
+      "required": true,
+      "description": "Dedicated MariaDB database for Guacamole"
+    },
+    {
+      "sname": "guacd",
+      "pname": "Guacamole Daemon",
+      "compose": "guacd.yml",
+      "installOrder": 2,
+      "waitForHealthy": false,
+      "required": true,
+      "description": "Guacamole connection proxy daemon"
+    }
+  ],
+
+  "requirements": {
+    "prerequisites": ["prerequisites"],
+    "apps": []
+  },
+
+  "database": {
+    "type": "mariadb",
+    "containerSname": "guacamole-mariadb",
+    "name": "guacamole",
+    "user": "guacamole_db_user",
+    "passwordVariable": "GUACAMOLE_MARIADB_PASSWORD",
+    "host": "guacamole-mariadb",
+    "port": 3306
+  },
+
+  "traefik": {
+    "supported": true
+  },
+
+  "dashboard": {
+    "enabled": true,
+    "location": "local",
+    "showStats": true,
+    "portVariable": "GUACAMOLE_PORT"
+  },
+
+  "hooks": {
+    "postInstall": "hooks/post-install.sh"
+  },
+
+  "env": {
+    "variables": [
+      {
+        "name": "GUACAMOLE_PORT",
+        "description": "Web interface port",
+        "type": "port",
+        "default": 8081,
+        "prompt": true,
+        "required": true,
+        "validation": { "type": "port", "min": 1, "max": 65535 }
+      },
+      {
+        "name": "GUACAMOLE_MARIADB_ROOT_PASSWORD",
+        "description": "MariaDB root password (auto-generated)",
+        "type": "password",
+        "generate": "random",
+        "length": 32,
+        "prompt": false,
+        "required": true
+      },
+      {
+        "name": "GUACAMOLE_MARIADB_PASSWORD",
+        "description": "MariaDB database password (auto-generated)",
+        "type": "password",
+        "generate": "random",
+        "length": 32,
+        "prompt": false,
+        "required": true
+      }
+    ]
+  },
+
+  "postInstall": {
+    "messages": [
+      {
+        "type": "info",
+        "text": "Default login: \\Z5guacadmin\\Zn / \\Z5guacadmin\\Zn - Change this immediately after first login!"
+      },
+      {
+        "type": "note",
+        "text": "Guacamole uses dedicated containers: \\Z5guacamole-mariadb\\Zn and \\Z5guacd\\Zn."
+      },
+      {
+        "type": "note",
+        "text": "Database credentials are stored in \\Z4$DOCKER_FOLDER/.env\\Zn."
+      }
+    ]
+  },
+
+  "status": {
+    "file": "06_guacamole_status",
+    "successMessage": "Guacamole Setup Completed",
+    "telemetryAction": "guacamole"
+  }
+}

package/apps/official/heimdall/compose.yml

@@ -0,0 +1,20 @@
+services:
+  # Heimdall - Application Dashboard
+  heimdall:
+    image: lscr.io/linuxserver/heimdall:latest
+    container_name: heimdall
+    security_opt:
+      - no-new-privileges:true
+    restart: unless-stopped
+    profiles: ["apps", "all"]
+    networks:
+      - default
+    ports:
+      - "$HEIMDALL_PORT:80"
+    volumes:
+      - $DOCKERDIR/appdata/heimdall:/config
+    environment:
+      PUID: $PUID
+      PGID: $PGID
+      TZ: $TZ
+    # DOCKER-LABELS-PLACEHOLDER

package/apps/official/heimdall/manifest.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "../../../apps/manifest-schema.json",
+  "version": "1.2",
+
+  "app": {
+    "sname": "heimdall",
+    "pname": "Heimdall",
+    "description": "Heimdall is an application dashboard and launcher. Organize all your web applications with a clean, customizable interface.",
+    "descriptionShort": "Homelab dashboard",
+    "icon": "sh-heimdall",
+    "category": "official",
+    "menuNumber": "06",
+    "tags": ["dashboard", "launcher", "organization", "web"]
+  },
+
+  "deployment": {
+    "type": "single",
+    "compose": "compose.yml",
+    "profiles": ["apps", "all"],
+    "networks": ["default"],
+    "webui": true,
+    "port": 8081,
+    "protocol": "http"
+  },
+
+  "requirements": {
+    "prerequisites": ["prerequisites"],
+    "apps": []
+  },
+
+  "traefik": {
+    "supported": true
+  },
+
+  "dashboard": {
+    "enabled": true,
+    "location": "local",
+    "showStats": true,
+    "portVariable": "HEIMDALL_PORT"
+  },
+
+  "env": {
+    "variables": [
+      {
+        "name": "HEIMDALL_PORT",
+        "description": "Web interface port",
+        "type": "port",
+        "default": 8081,
+        "prompt": true,
+        "required": true,
+        "validation": {
+          "type": "port",
+          "min": 1,
+          "max": 65535
+        }
+      }
+    ]
+  },
+
+  "status": {
+    "file": "06_heimdall_status",
+    "successMessage": "Heimdall Setup Completed",
+    "telemetryAction": "heimdall"
+  }
+}

package/apps/official/homarr/compose.yml

@@ -0,0 +1,22 @@
+services:
+  # Homarr - Application Dashboard
+  homarr:
+    image: ghcr.io/homarr-labs/homarr:latest
+    container_name: homarr
+    security_opt:
+      - no-new-privileges:true
+    restart: unless-stopped
+    profiles: ["apps", "all"]
+    networks:
+      - default
+      - socket_proxy
+    ports:
+      - "$HOMARR_PORT:7575"
+    volumes:
+      - $DOCKERDIR/appdata/homarr/configs:/app/data/configs
+      - $DOCKERDIR/appdata/homarr/icons:/app/public/icons
+      - $DOCKERDIR/appdata/homarr/data:/data
+    environment:
+      TZ: $TZ
+      DOCKER_HOST: $DOCKER_HOST
+    # DOCKER-LABELS-PLACEHOLDER

package/apps/official/homarr/manifest.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "../../../apps/manifest-schema.json",
+  "version": "1.2",
+
+  "app": {
+    "sname": "homarr",
+    "pname": "Homarr",
+    "description": "Homarr is a sleek, modern dashboard that puts all of your apps and services at your fingertips. With Homarr you can access and control everything in one convenient location.",
+    "descriptionShort": "Homelab dashboard",
+    "icon": "sh-homarr",
+    "category": "official",
+    "menuNumber": "06",
+    "tags": ["dashboard", "homepage", "widgets", "integrations"]
+  },
+
+  "deployment": {
+    "type": "single",
+    "compose": "compose.yml",
+    "profiles": ["apps", "all"],
+    "networks": ["default", "socket_proxy"],
+    "webui": true,
+    "port": 7575,
+    "protocol": "http"
+  },
+
+  "requirements": {
+    "prerequisites": ["prerequisites"],
+    "apps": ["socket-proxy"]
+  },
+
+  "traefik": {
+    "supported": true
+  },
+
+  "dashboard": {
+    "enabled": true,
+    "location": "local",
+    "showStats": true,
+    "portVariable": "HOMARR_PORT"
+  },
+
+  "folders": {
+    "appdata": [
+      "homarr/configs",
+      "homarr/icons",
+      "homarr/data"
+    ]
+  },
+
+  "env": {
+    "variables": [
+      {
+        "name": "HOMARR_PORT",
+        "description": "Web interface port",
+        "type": "port",
+        "default": 7575,
+        "prompt": true,
+        "required": true,
+        "validation": {
+          "type": "port",
+          "min": 1,
+          "max": 65535
+        }
+      }
+    ]
+  },
+
+  "status": {
+    "file": "06_homarr_status",
+    "successMessage": "Homarr Setup Completed",
+    "telemetryAction": "homarr"
+  }
+}

package/apps/official/homebridge/compose.yml

@@ -0,0 +1,13 @@
+services:
+  # Homebridge - iOS HomeKit API
+  homebridge:
+    image: homebridge/homebridge:latest
+    container_name: homebridge
+    security_opt:
+      - no-new-privileges:true
+    restart: unless-stopped
+    profiles: ["apps", "all"]
+    network_mode: host
+    volumes:
+      - $DOCKERDIR/appdata/homebridge:/homebridge
+    # DOCKER-LABELS-PLACEHOLDER

package/apps/official/homebridge/manifest.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "../../../apps/manifest-schema.json",
+  "version": "1.2",
+
+  "app": {
+    "sname": "homebridge",
+    "pname": "Homebridge",
+    "description": "Homebridge allows you to integrate with smart home devices that do not natively support HomeKit. It acts as a bridge between HomeKit and third-party home automation systems.",
+    "descriptionShort": "Integration for HomeKit devices",
+    "icon": "sh-homebridge",
+    "category": "official",
+    "menuNumber": "06",
+    "tags": ["automation", "homekit", "smart-home"]
+  },
+
+  "deployment": {
+    "type": "single",
+    "compose": "compose.yml",
+    "profiles": ["apps", "all"],
+    "networks": [],
+    "networkMode": "host",
+    "webui": true,
+    "port": 8581,
+    "protocol": "http"
+  },
+
+  "requirements": {
+    "prerequisites": ["prerequisites"],
+    "apps": []
+  },
+
+  "traefik": {
+    "supported": true
+  },
+
+  "dashboard": {
+    "enabled": true,
+    "location": "local",
+    "showStats": true,
+    "portVariable": "HOMEBRIDGE_PORT"
+  },
+
+  "env": {
+    "variables": [
+      {
+        "name": "HOMEBRIDGE_PORT",
+        "description": "Web interface port",
+        "type": "port",
+        "default": 8581,
+        "prompt": true,
+        "required": true,
+        "validation": {
+          "type": "port",
+          "min": 1,
+          "max": 65535
+        }
+      }
+    ]
+  },
+
+  "status": {
+    "file": "06_homebridge_status",
+    "successMessage": "Homebridge Setup Completed",
+    "telemetryAction": "homebridge"
+  }
+}

package/apps/official/homepage/compose.yml

@@ -0,0 +1,22 @@
+services:
+  # Homepage - Application Dashboard
+  homepage:
+    image: ghcr.io/gethomepage/homepage:latest
+    container_name: homepage
+    security_opt:
+      - no-new-privileges:true
+    restart: unless-stopped
+    profiles: ["apps", "all"]
+    networks:
+      - default
+      - socket_proxy
+    ports:
+      - "$HOMEPAGE_PORT:3000"
+    volumes:
+      - $DOCKERDIR/appdata/homepage:/app/config
+    environment:
+      TZ: $TZ
+      PUID: $PUID
+      PGID: $PGID
+      HOMEPAGE_ALLOWED_HOSTS: "*"
+    # DOCKER-LABELS-PLACEHOLDER

package/apps/official/homepage/manifest.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "../../../apps/manifest-schema.json",
+  "version": "1.2",
+
+  "app": {
+    "sname": "homepage",
+    "pname": "Homepage",
+    "description": "Homepage is a modern, fully static, fast, and secure application dashboard with over 100 integrations and widgets. It supports Docker integration for automatic service discovery.",
+    "descriptionShort": "Homelab dashboard",
+    "icon": "sh-homepage",
+    "category": "official",
+    "menuNumber": "06",
+    "tags": ["dashboard", "homepage", "widgets", "integrations"]
+  },
+
+  "deployment": {
+    "type": "single",
+    "compose": "compose.yml",
+    "profiles": ["apps", "all"],
+    "networks": ["default", "socket_proxy"],
+    "webui": true,
+    "port": 3001,
+    "protocol": "http"
+  },
+
+  "requirements": {
+    "prerequisites": ["prerequisites"],
+    "apps": ["socket-proxy"]
+  },
+
+  "traefik": {
+    "supported": true
+  },
+
+  "dashboard": {
+    "enabled": true,
+    "location": "local",
+    "showStats": true,
+    "portVariable": "HOMEPAGE_PORT"
+  },
+
+  "env": {
+    "variables": [
+      {
+        "name": "HOMEPAGE_PORT",
+        "description": "Web interface port",
+        "type": "port",
+        "default": 3001,
+        "prompt": true,
+        "required": true,
+        "validation": {
+          "type": "port",
+          "min": 1,
+          "max": 65535
+        }
+      }
+    ]
+  },
+
+  "status": {
+    "file": "06_homepage_status",
+    "successMessage": "Homepage Setup Completed",
+    "telemetryAction": "homepage"
+  }
+}

package/apps/official/homer/compose.yml

@@ -0,0 +1,20 @@
+services:
+  # Homer - Application Dashboard
+  homer:
+    image: b4bz/homer:latest
+    container_name: homer
+    security_opt:
+      - no-new-privileges:true
+    restart: unless-stopped
+    profiles: ["apps", "all"]
+    networks:
+      - default
+      - socket_proxy
+    ports:
+      - "$HOMER_PORT:8080"
+    volumes:
+      # - /var/run/docker.sock:/var/run/docker.sock # Optional, only if you want docker integration
+      - $DOCKERDIR/appdata/homer:/www/assets
+    environment:
+      - DOCKER_HOST
+    # DOCKER-LABELS-PLACEHOLDER