shelly-manager

Overview

Shelly Manager - Local management for Shelly IoT devices without cloud connectivity. Includes device discovery, firmware updates, bulk operations, and a modern web UI.

Runtime arguments

Web UI: http://[IP]:[PORT:8080]/
Network: bridge
Privileged: false
Extra Params: --restart unless-stopped

Template configuration

WebUI PortPorttcp

Web interface and API port

Target: 8080
Default: 8080

Config PathPathrw

Path for persistent data (database)

Target: /config
Default: /mnt/user/appdata/shelly-manager

Secret KeyVariable

Encryption key for stored credentials. Generate with: python3 -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())'

Target: SHELLY_SECRET_KEY

Log LevelVariable

Logging verbosity (debug, info, warning, error)

Target: LOG_LEVEL
Default: info

PUIDVariable

User ID for file permissions

Default: 1000

PGIDVariable

Group ID for file permissions

Default: 1000

Web PortVariable

Internal port for the web UI and nginx reverse proxy (change if 8080 conflicts in host network mode)

Target: PORT
Default: 8080

API PortVariable

Internal port for the API server (change if 8000 conflicts in host network mode)

Target: API_PORT
Default: 8000

API URL OverrideVariable

Override the API base URL (e.g., behind a reverse proxy). Leave empty to auto-detect from browser URL.

Target: VITE_BASE_API_URL

Links

Template Support Registry Project

Details

Repository

ghcr.io/jfmlima/shelly-manager:latest

Registry

https://github.com/jfmlima/unraid-templates/pkgs/container/shelly-manager

Last Updated2026-06-01

First Seen2026-05-19

Run shelly-manager on Unraid.

shelly-manager is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS