Services

Example configurations for different services.

AdguardTeam/AdGuardHome

Source: https://github.com/AdguardTeam/AdGuardHome

deployed_version - Requires USERNAME and PASSWORD Basic Auth credentials created during the setup wizard on first launch unless you explicitly disabled it.

service: AdguardTeam/AdGuardHome: latest_version: type: github url: AdguardTeam/AdGuardHome url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://adguard.example.io/control/status basic_auth: username: <USERNAME> password: <PASSWORD> json: version regex: v([0-9.]+) dashboard: web_url: https://github.com/AdguardTeam/AdGuardHome/releases/v{{ version }} icon: https://avatars.githubusercontent.com/u/8361145?s=200&v=4

adnanh/webhook

Source: https://github.com/adnanh/webhook

service: adnanh/webhook: latest_version: type: github url: adnanh/webhook require: regex_content: webhook-linux-amd64\.tar\.gz dashboard: web_url: https://github.com/adnanh/webhook/releases/{{ version }} icon: https://raw.githubusercontent.com/adnanh/webhook/development/docs/logo/logo-128x128.png

advplyr/audiobookshelf

Source: https://github.com/advplyr/audiobookshelf

service: advplyr/audiobookshelf: latest_version: type: github url: advplyr/audiobookshelf url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://audiobookshelf.example.io/status json: serverVersion dashboard: icon: https://raw.githubusercontent.com/advplyr/audiobookshelf/master/client/static/icon.svg web_url: https://github.com/advplyr/audiobookshelf/releases/tag/v{{ version }}

aizhimou/pigeon-pod

Source: https://github.com/aizhimou/pigeon-pod

service: aizhimou/pigeon-pod: name: Pigeon Pod latest_version: type: github url: aizhimou/pigeon-pod deployed_version: method: GET url: https://example.com/ allow_invalid_certs: false regex: 'meta name="version" content="([0-9.]+)"' dashboard: web_url: https://github.com/aizhimou/pigeon-pod/releases/tag/{{ version }} icon: https://pigeonpod.cloud/assets/pigeonpod-YAUI8Oed.svg

ansible/awx

Source: https://github.com/ansible/awx

service: ansible/awx: latest_version: type: github url: ansible/awx deployed_version: url: https://awx.example.io/api/v2/ping/?format=json json: version dashboard: web_url: https://github.com/ansible/awx/releases/{{ version }} icon: https://raw.githubusercontent.com/ansible/awx-logos/master/awx/ui/client/assets/logo-login.svg

ansible/awx-operator

Source: https://github.com/ansible/awx-operator

service: ansible/awx-operator: latest_version: type: github url: ansible/awx-operator dashboard: web_url: https://github.com/ansible/awx-operator/releases/{{ version }} icon: https://raw.githubusercontent.com/ansible/awx-logos/master/awx/ui/client/assets/logo-login.svg

argoproj/argo-cd

Source: https://github.com/argoproj/argo-cd

service: argoproj/argo-cd: latest_version: type: github url: argoproj/argo-cd url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://argocd.example.io/api/version json: Version regex: v([0-9.]+) dashboard: web_url: https://github.com/argoproj/argo-cd/releases/v{{ version }} icon: https://avatars.githubusercontent.com/u/30269780?s=200&v=4

bitmagnet-io/bitmagnet

Source: https://github.com/bitmagnet-io/bitmagnet

service: bitmagnet-io/bitmagnet: latest_version: type: github url: bitmagnet-io/bitmagnet require: docker: type: ghcr image: bitmagnet-io/bitmagnet tag: 'v{{ version }}' deployed_version: type: url url: https://bitmagnet.example.com/status json: info.version regex: "([0-9.]+)" dashboard: icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/bitmagnet.png web_url: https://github.com/bitmagnet-io/bitmagnet/releases/tag/v{{ version }}

dani-garcia/vaultwarden

Source: https://github.com/dani-garcia/vaultwarden

deployed_version - Requires version 1.25.0 of Vaultwarden

service: dani-garcia/vaultwarden: latest_version: type: github url: dani-garcia/vaultwarden require: docker: type: hub image: vaultwarden/server tag: '{{ version }}' deployed_version: type: url url: http://vaultwarden.example.com/api/version regex: "([0-9.]+)" dashboard: web_url: https://github.com/dani-garcia/vaultwarden/releases/{{ version }} icon: https://raw.githubusercontent.com/dani-garcia/vaultwarden/main/src/static/images/vaultwarden-icon.png

Freika/dawarich

Source: https://github.com/Freika/dawarich

service: Freika/dawarich: latest_version: type: github url: Freika/dawarich require: docker: type: hub image: freikin/dawarich tag: '{{ version }}' deployed_version: type: url url: http://dawarich.example.com/api/v1/health target_header: x-dawarich-version dashboard: icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/dawarich.png web_url: https://github.com/Freika/dawarich/releases/tag/{{ version }}

dgtlmoon/changedetection.io

Source: https://github.com/dgtlmoon/changedetection.io

You must use the API Key created: Settings > API > API Access

service: dgtlmoon/changedetection.io: name: Change Detection latest_version: type: github url: dgtlmoon/changedetection.io deployed_version: url: https://example.com/api/v1/systeminfo regex: version":\s*"([^"]+) headers: - key: x-api-key value: YOUR_API_KEY dashboard: web_url: https://github.com/dgtlmoon/changedetection.io/releases/tag/{{ version }} icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/changedetection.png

element-hq/synapse

Source: https://github.com/element-hq/synapse

service: element-hq/synapse: latest_version: type: github url: element-hq/synapse url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://matrix.example.io/_synapse/admin/v1/server_version json: server_version dashboard: web_url: https://github.com/element-hq/synapse/releases/tag/v{{ version }} icon: https://github.com/element-hq/synapse/raw/develop/docs/favicon.svg

ellite/Wallos

service: ellite/Wallos: latest_version: type: github url: ellite/Wallos deployed_version: method: GET url: http://wallos.com/api/status/version.php?api_key=xxx json: version_number dashboard: icon: https://github.com/ellite/Wallos/raw/main/images/siteicons/wallos.png web_url: https://github.com/ellite/Wallos/releases

emqx/emqx

Source: https://github.com/emqx/emqx

service: emqx/emqx: latest_version: type: github url: emqx/emqx deployed_version: method: GET url: http://emqx.example.io:18083/api/v5/status?format=json basic_auth: username: api_key password: secret_key regex: "[0-9].+" json: rel_vsn dashboard: icon: https://static-00.iconduck.com/assets.00/emqx-icon-1775x2048-z0dsscdr.png web_url: https://www.emqx.io/docs/en/latest/changes/changes-ce-v5.html#_{{ rel_vsn | split:"." | slice:":2" | join:"-" }}

Fallenbagel/jellyseerr

Source: https://github.com/Fallenbagel/jellyseerr

service: Fallenbagel/jellyseerr: latest_version: type: github url: Fallenbagel/jellyseerr url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: http://jellyseerr.example.io/api/v1/status json: version dashboard: web_url: https://github.com/Fallenbagel/jellyseerr/releases/v{{ version }} icon: https://raw.githubusercontent.com/Fallenbagel/jellyseerr/develop/public/os_icon.svg

firefly-iii/firefly-iii

Source: https://github.com/firefly-iii/firefly-iii

To get the deployed_version you need a Personal-Access-Token from your Firefly III instance. (instructions)

service: firefly-iii/firefly-iii: latest_version: type: github url: firefly-iii/firefly-iii url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://firefly.example.io/api/v1/about json: data.version headers: - key: Authorization value: Bearer <Personal-Access-Token> dashboard: icon: https://raw.githubusercontent.com/firefly-iii/firefly-iii/main/public/images/logo.png web_url: https://github.com/firefly-iii/firefly-iii/releases/tag/v{{ version }}

FlareSolverr/FlareSolverr

Source: https://github.com/FlareSolverr/FlareSolverr

service: FlareSolverr/FlareSolverr: latest_version: type: github url: FlareSolverr/FlareSolverr url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://flaresolverr.example.io json: version dashboard: icon: https://raw.githubusercontent.com/FlareSolverr/FlareSolverr/master/resources/flaresolverr_logo.png web_url: https://github.com/FlareSolverr/FlareSolverr/releases/tag/v{{ version }}

Forgejo

Source: https://codeberg.org/forgejo

service: Forgejo: latest_version: type: url url: https://code.forgejo.org/api/v1/repos/forgejo/forgejo/releases url_commands: - type: regex regex: "['\"]tag_name['\"]: *['\"]v?([0-9.]+)['\"]" deployed_version: type: url url: http://git.example.com regex: Powered by Forgejo.*\s+Version:\s+([0-9.]+) dashboard: icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/forgejo.png web_url: https://codeberg.org/forgejo/forgejo/releases/tag/v{{ version }}

FreshRSS/FreshRSS

Source: https://github.com/FreshRSS/FreshRSS

service: FreshRSS/FreshRSS: latest_version: type: github url: FreshRSS/FreshRSS deployed_version: method: GET url: https://freshrss.example.io regex: '"version":"([0-9.]+)"' dashboard: icon: https://raw.githubusercontent.com/FreshRSS/FreshRSS/edge/p/themes/icons/favicon-256.png web_url: https://github.com/FreshRSS/FreshRSS/releases/tag/{{ version }}

gitlab-org/gitlab

Source: https://gitlab.com/gitlab-org/gitlab

To get the latest version of the ‘Enterprise Edition’, change the ce to ee in the url_commands regex.

deployed_version - Requires an Access_Token from your GitLab instance. (instructions)

service: gitlab-org/gitlab: latest_version: type: url url: https://gitlab.com/api/v4/projects/278964/repository/tags url_commands: - type: regex regex: \"name\":\"v([0-9.]+\-ce)\" deployed_version: url: https://gitlab.example.com/api/v4/version headers: - key: PRIVATE-TOKEN value: <Access_Token> json: version dashboard: web_url: https://gitlab.com/gitlab-org/gitlab/-/blob/master/CHANGELOG.md icon: https://gitlab.com/gitlab-org/gitlab/-/raw/master/public/slash-command-logo.png

glanceapp/glance

Source: https://github.com/glanceapp/glance

service: glanceapp/glance: latest_version: type: github url: glanceapp/glance url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://glance.example.io regex: v([0-9.]+) dashboard: icon: https://raw.githubusercontent.com/glanceapp/glance/main/internal/assets/static/app-icon.png web_url: https://github.com/glanceapp/glance/releases/tag/v{{ version }}

go-gitea/gitea

Source: https://github.com/go-gitea/gitea:

service: go-gitea/gitea: latest_version: type: github url: go-gitea/gitea url_commands: - type: regex regex: v([0-9.]+)$ require: regex_content: gitea-{{ version }}-linux-amd64 regex_version: ^[0-9.]+[0-9]$ deployed_version: url: https://git.example.io regex: 'Powered by Gitea\s+Version:\s+([0-9.]+) ' dashboard: web_url: https://github.com/go-gitea/gitea/releases/v{{ version }} icon: https://raw.githubusercontent.com/go-gitea/gitea/main/public/img/logo.png

go-vikunja/vikunja

Source: https://github.com/go-vikunja/vikunja

service: go-vikunja/vikunja: latest_version: type: github url: go-vikunja/vikunja url_commands: - type: regex regex: v([0-9.]+) require: docker: type: hub image: vikunja/vikunja tag: '{{ version }}' deployed_version: type: url url: http://vikunja.example.com/api/v1/info json: version regex: v?([0-9.]+) dashboard: web_url: https://github.com/go-vikunja/vikunja/releases/tag/v{{ version }} icon: https://vikunja.io/images/vikunja.png

goauthentik/authentik

Source: https://github.com/goauthentik/authentik

deployed_version - Requires an API_Token with API Access rights. (can be done at Directory/Tokens & App password / /if/admin/#/core/tokens as of ‘2022.4.1’)

service: goauthentik/authentik: latest_version: type: github url: goauthentik/authentik url_commands: - type: regex regex: version\/([0-9.]+[0-9]+(?:-rc[0-9])?) require: docker: type: ghcr image: goauthentik/server tag: '{{ version }}' deployed_version: url: https://authentik.example.io/api/v3/admin/version/ headers: - key: Authorization value: bearer <API_Token> json: version_current dashboard: web_url: https://goauthentik.io/docs/releases/{{ version | split:"." | slice:":-1" | join:"." }} icon: https://raw.githubusercontent.com/goauthentik/authentik/master/web/icons/icon.png

goharbor/harbor

Source: https://github.com/goharbor/harbor

service: goharbor/harbor: latest_version: type: github url: goharbor/harbor url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://harbor.example.io/api/v2.0/systeminfo json: harbor_version regex: v([0-9.]+) dashboard: web_url: https://github.com/goharbor/harbor/releases/tag/v{{ version }} icon: https://github.com/goharbor/harbor/raw/main/src/portal/src/images/harbor-logo.svg

gohugoio/hugo

Source: https://github.com/gohugoio/hugo

service: gohugoio/hugo: latest_version: type: github url: gohugoio/hugo url_commands: - type: regex regex: v([0-9.]+)$ require: regex_content: hugo_{{ version }}_Linux-64bit\.deb dashboard: web_url: https://github.com/gohugoio/hugo/releases/v{{ version }} icon: https://raw.githubusercontent.com/gohugoio/hugo/master/docs/static/img/hugo.png

golang/go

Source: https://github.com/golang/go

service: golang/go: options: semantic_versioning: false latest_version: type: url url: https://golang.org/dl/ url_commands: - type: regex regex: go([0-9.]+[0-9]+)\.src\.tar\.gz dashboard: web_url: https://go.dev/doc/go{{ version | split:"." | slice:":2" | join:"." }} icon: https://go.dev/images/gophers/motorcycle.svg

gotify/server

Source: https://github.com/gotify/server

service: gotify/server: latest_version: type: github url: gotify/server url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://gotify.example.io/version json: version dashboard: web_url: https://github.com/gotify/server/releases/v{{ version }} icon: https://github.com/gotify/logo/raw/master/gotify-logo.png

grafana/grafana

Source: https://github.com/grafana/grafana

service: grafana/grafana: latest_version: type: github url: grafana/grafana url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://grafana.example.io/login regex: v([0-9.]+)\s\([0-9a-z]+\) dashboard: web_url: https://github.com/grafana/grafana/releases/tag/v{{ version }} icon: https://cdn.worldvectorlogo.com/logos/grafana.svg

grafana/loki

Source: https://github.com/grafana/loki

service: grafana/loki: latest_version: type: github url: grafana/loki url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://loki.example.io/loki/api/v1/status/buildinfo json: version dashboard: web_url: https://grafana.com/docs/loki/latest/release-notes/v{{ version | split:"." | slice:":2" | join:"-" }} icon: https://grafana.com/static/assets/img/blog/loki.png

hashicorp/vault

Source: https://github.com/hashicorp/vault

service: hashicorp/vault: latest_version: type: github url: hashicorp/vault url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://vault.example.io/v1/sys/health json: version dashboard: web_url: https://github.com/hashicorp/vault/releases/v{{ version }} icon: https://raw.githubusercontent.com/hashicorp/vault/main/ui/public/vault-logo.svg

healthchecks/healthchecks

Source: https://github.com/healthchecks/healthchecks

service: healthchecks/healthchecks: options: semantic_versioning: false latest_version: type: github url: healthchecks/healthchecks url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://healthchecks.example.io/docs/ regex: Healthchecks v([0-9.]+) dashboard: web_url: https://github.com/healthchecks/healthchecks/releases/tag/{{ version }} icon: https://healthchecks.io/static/img/logo-rounded.svg

hedgedoc/hedgedoc

Source: https://github.com/hedgedoc/hedgedoc

service: hedgedoc/hedgedoc: latest_version: type: github url: hedgedoc/hedgedoc require: regex_version: ^[0-9.]+$ deployed_version: url: https://hedgedoc.example.io/config regex: window.version = '([0-9.]+)-[0-9a-z]+' dashboard: web_url: https://github.com/hedgedoc/hedgedoc/releases/tag/{{ version }} icon: https://raw.githubusercontent.com/hedgedoc/hedgedoc/master/public/icons/android-chrome-512x512.png

hoarder-app/hoarder

Source: https://github.com/hoarder-app/hoarder

service: hoarder-app/hoarder: latest_version: type: github url: hoarder-app/hoarder url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://hoarder.example.io/ regex: \\"serverVersion\\":\\"([0-9.]+)\\" dashboard: icon: https://raw.githubusercontent.com/hoarder-app/hoarder/main/apps/web/public/icons/logo-128.png web_url: https://github.com/hoarder-app/hoarder/releases/v{{ version }}

home-assistant/core

Source: https://github.com/home-assistant/core

deployed_version - API_Token obtained by navigating to ‘/profile’ and creating a ‘Long-Lived Access Token’. (instructions)

service: home-assistant/core: latest_version: type: github url: home-assistant/core require: regex_version: ^[0-9.]+$ deployed_version: url: https://home-assistant.example.io/api/config json: version headers: - key: Authorization value: Bearer <API_Token> dashboard: web_url: https://www.home-assistant.io/latest-release-notes icon: https://github.com/home-assistant/core/raw/dev/tests/components/image_upload/logo.png

immich-app/immich

Source: https://github.com/immich-app/immich

deployed_version - Requires an IMMICH_API_KEY which can be retrieved at Account Settings/API Keys

service: immich-app/immich: latest_version: type: github url: immich-app/immich require: docker: type: ghcr image: immich-app/immich-server tag: 'v{{ version }}' deployed_version: url: https://immich.example.io/api/server/about json: version regex: ^v([0-9.]+)$ headers: - key: x-api-key value: ${IMMICH_API_KEY} dashboard: icon: https://raw.githubusercontent.com/immich-app/immich/main/web/static/immich-logo.svg web_url: https://github.com/immich-app/immich/releases/tag/v{{ version }}

influxdata/influxdb

Source: https://github.com/influxdata/influxdb

service: influxdata/influxdb: latest_version: type: github url: influxdata/influxdb url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://influxdb.example.io/health json: version dashboard: web_url: https://github.com/influxdata/influxdb/releases/tag/v{{ version }} icon: https://github.com/influxdata/ui/raw/master/src/writeData/graphics/influxdb.svg

jellyfin/jellyfin

Source: https://github.com/jellyfin/jellyfin

service: jellyfin/jellyfin: latest_version: type: github url: jellyfin/jellyfin url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://jellyfin.example.io/System/Info/Public json: Version dashboard: web_url: https://github.com/jellyfin/jellyfin/releases/v{{ version }} icon: https://avatars.githubusercontent.com/u/45698031?s=200&v=4

jgraph/drawio

Source: https://github.com/jgraph/drawio

service: jgraph/drawio: latest_version: type: github url: jgraph/drawio url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://draw.example.io/package.json json: version dashboard: web_url: https://github.com/jgraph/drawio/releases/v{{ version }} icon: https://github.com/jgraph/drawio/raw/dev/src/main/webapp/images/drawlogo-color.svg

Lidarr/Lidarr

Source: https://github.com/Lidarr/Lidarr

deployed_version - Requires an API_KEY which can be retrieved at Settings/General/Security/API Key

service: Lidarr/Lidarr: options: semantic_versioning: false latest_version: type: github url: Lidarr/Lidarr url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://lidarr.example.io/api/v1/system/status headers: - key: X-Api-Key value: <API_KEY> json: version dashboard: icon: https://raw.githubusercontent.com/Lidarr/Lidarr/develop/Logo/1024.png web_url: https://github.com/Lidarr/Lidarr/releases/v{{ version }}

linkwarden/linkwarden

Source: https://github.com/linkwarden/linkwarden

service: linkwarden/linkwarden: latest_version: type: github url: linkwarden/linkwarden require: docker: type: ghcr image: linkwarden/linkwarden tag: 'v{{ version }}' deployed_version: type: url url: https://linkwarden.example.com/api/v1/config json: response.INSTANCE_VERSION regex: "([0-9.]+)" dashboard: icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/linkwarden.png web_url: https://github.com/linkwarden/linkwarden/releases/tag/v{{ version }}

louislam/uptime-kuma

Source: https://github.com/louislam/uptime-kuma

service: louislam/uptime-kuma: latest_version: type: github url: louislam/uptime-kuma require: docker: type: hub image: louislam/uptime-kuma tag: '{{ version }}-slim' deployed_version: url: https://status.example.io/metrics regex: app_version{version=\"([0-9.]+)\",major=\"[0-9]+\",minor=\"[0-9]+\",patch=\"[0-9]+\"} dashboard: web_url: https://github.com/louislam/uptime-kuma/releases/{{ version }} icon: https://raw.githubusercontent.com/louislam/uptime-kuma/master/public/icon.png

mailcow/mailcow-dockerized

Source: https://github.com/mailcow/mailcow-dockerized

service: mailcow/mailcow-dockerized: options: semantic_versioning: false latest_version: type: github url: mailcow/mailcow-dockerized require: regex_version: ^[0-9-]+[a-z]?$ deployed_version: url: https://mailcow.example.io/api/v1/get/status/version headers: - key: X-API-Key value: <ReadOnly-API-Key> json: version dashboard: web_url: https://github.com/mailcow/mailcow-dockerized/releases/tag/{{ version }} icon: https://raw.githubusercontent.com/mailcow/mailcow-dockerized/master/data/web/img/cow_mailcow.svg

matomo-org/matomo

Source: https://github.com/matomo-org/matomo

deployed_version - TOKEN can be generated in the personal settings under security. (instructions)

service: matomo-org/matomo: latest_version: type: github url: matomo-org/matomo require: regex_version: ^[0-9.]+$ deployed_version: url: https://matomo.example.io/index.php?module=API&method=API.getMatomoVersion&format=JSON&force_api_session=1&token_auth=<TOKEN> json: value dashboard: web_url: https://github.com/matomo-org/matomo/releases/tag/{{ version }} icon: https://raw.githubusercontent.com/matomo-org/matomo/4.x-dev/plugins/CoreHome/images/applogo_732.png

mattermost/mattermost-server

Source: https://github.com/mattermost/mattermost-server

service: mattermost/mattermost-server: latest_version: type: url url: https://mattermost.com/deploy/ url_commands: - type: regex regex: releases\.mattermost\.com\/([^\/]+)\/mattermost-[0-9.]+-linux\-amd64\.tar\.gz dashboard: web_url: https://docs.mattermost.com/install/self-managed-changelog.html

mealie-recipes/mealie:

Source: https://github.com/mealie-recipes/mealie

service: mealie-recipes/mealie: name: Mealie latest_version: type: github url: mealie-recipes/mealie url_commands: - type: regex regex: ^v?([0-9.]+)$ deployed_version: url: https://example.com/api/app/about regex: version":\s*"v?(\d+\.\d+\.\d+) dashboard: web_url: https://github.com/mealie-recipes/mealie/releases/tag/v{{ version }} icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mealie.png

moghtech/komodo

Source: https://github.com/moghtech/komodo

deployed_version requires a token pair, KOMODO_API_KEY and KOMODO_API_SECRET. Add a service user with limited permissions and generate an API key for him.

service: moghtech/komodo: latest_version: type: github url: moghtech/komodo require: docker: type: ghcr image: moghtech/komodo-core tag: '{{ version }}' deployed_version: type: url method: POST url: http://komodo.example.com/read/GetVersion body: "{}" json: version headers: - key: x-api-key value: ${KOMODO_API_KEY} - key: x-api-secret value: ${KOMODO_API_SECRET} - key: Content-Type value: application/json; charset=utf8 dashboard: icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/komodo.png web_url: https://github.com/moghtech/komodo/releases/tag/v{{ version }}

morpheus65535/bazarr

Source: https://github.com/morpheus65535/bazarr

deployed_version - Requires an API_KEY which can be retrieved at Settings/General/Security/API Key

service: morpheus65535/bazarr: latest_version: type: github url: morpheus65535/bazarr url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://bazarr.example.io/api/system/status headers: - key: X-API-KEY value: <API_KEY> json: data.bazarr_version dashboard: web_url: https://github.com/morpheus65535/bazarr/releases/v{{ version }} icon: https://raw.githubusercontent.com/morpheus65535/bazarr/master/frontend/public/images/logo128.png

n8n-io/n8n

Source: https://github.com/n8n-io/n8n

If you deploy in docker, you must add this environment: N8N_METRICS=true

service: n8n-io/n8n: latest_version: type: url url: https://github.com/n8n-io/n8n/tags url_commands: - type: regex regex: n8n\%40([0-9.]+) dashboard: web_url: https://github.com/n8n-io/n8n/blob/master/CHANGELOG.md icon: https://raw.githubusercontent.com/n8n-io/n8n-docs/main/docs/_images/n8n-docs-icon.svg

netbox-community/netbox

Source: https://github.com/netbox-community/netbox

service: netbox-community/netbox: latest_version: type: github url: netbox-community/netbox url_commands: - type: regex regex: v([0-9.]+)$ require: regex_version: ^[0-9.]+$ deployed_version: url: https://netbox.example.io/api/status/ json: netbox-version dashboard: web_url: https://github.com/netbox-community/netbox/releases/tag/v{{ version }} icon: https://github.com/netbox-community/netbox/raw/develop/netbox/project-static/img/netbox_icon.svg

nextcloud/server

Source: https://github.com/nextcloud/server

service: nextcloud/server: latest_version: type: github url: nextcloud/server url_commands: - type: regex regex: v([0-9.]+)$ require: docker: type: hub image: nextcloud tag: '{{ version }}-fpm-alpine' deployed_version: url: https://nextcloud.example.io/status.php json: versionstring dashboard: web_url: https://nextcloud.com/changelog/#latest{{ version | split:"." | slice:":1" | join:"" }} icon: https://github.com/nextcloud/server/raw/master/core/img/favicon.png

OliveTin/OliveTin

Source: https://github.com/OliveTin/OliveTin

service: OliveTin/OliveTin: options: semantic_versioning: false latest_version: type: github url: OliveTin/OliveTin deployed_version: method: GET url: https://olivetin.example.io/webUiSettings.json json: CurrentVersion dashboard: icon: https://github.com/OliveTin/OliveTin/raw/main/webui.dev/OliveTinLogo.png web_url: https://github.com/OliveTin/OliveTin/releases/tag/{{ version }}

opencve/opencve

Source: https://github.com/opencve/opencve

service: opencve/opencve: latest_version: type: github url: opencve/opencve url_commands: - type: regex regex: v([0-9.]+)$ dashboard: web_url: https://github.com/opencve/opencve/releases/v{{ version }} icon: https://raw.githubusercontent.com/opencve/opencve/master/opencve/static/img/logo_white.png

opnsense/core

Source: https://github.com/opnsense/core

deployed_version - Create an API Key. (instructions)

service: opnsense/core: latest_version: type: url url: https://github.com/opnsense/core/tags url_commands: - type: regex regex: \/releases\/tag\/([0-9.]+)\" deployed_version: url: https://opnsense.example.io/api/core/firmware/status basic_auth: username: <API Key> password: <API Secret> json: product.product_version regex: ([0-9.]+) dashboard: web_url: https://docs.opnsense.org/CE_releases.html icon: https://github.com/opnsense/core/raw/master/src/opnsense/www/themes/opnsense/build/images/icon-logo.svg

outline/outline

Source: https://github.com/outline/outline

You must create a API Key: Settings > API & Apps > + New API key...

service: outline/outline: name: Outline latest_version: type: github url: outline/outline url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: POST url: https://example.com/api/installation.info allow_invalid_certs: false headers: - key: Authorization value: 'Bearer YOUR_API_KEY' - key: Content-Type value: 'application/json' body: "{}" json: data.version regex: '([0-9.]+)' dashboard: web_url: https://github.com/outline/outline/releases/tag/v{{ version }} icon: https://www.getoutline.com/images/logo.svg

paperless-ngx/paperless-ngx

Source: https://github.com/paperless-ngx/paperless-ngx

deployed_version - Requires a PAPERLESS_NGX_API_KEY. Create a service user and generate a token in the profile.

service: paperless-ngx/paperless-ngx: latest_version: type: github url: paperless-ngx/paperless-ngx require: docker: type: ghcr image: paperless-ngx/paperless-ngx tag: '{{ version }}' deployed_version: type: url url: http://paperlessngx.example.com/api/status/ json: pngx_version headers: - key: Authorization value: Token ${PAPERLESS_NGX_API_KEY} dashboard: icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/paperless-ngx.png icon_link_to: https://papers.nanode.su web_url: https://github.com/paperless-ngx/paperless-ngx/releases/tag/v{{ version }}

Plex Media Server

Source: https://plex.tv

deployed_version - Requires a TOKEN. Instructions to get one here.

service: Plex Media Server: options: semantic_versioning: false latest_version: type: url url: https://plex.tv/api/downloads/5.json url_commands: - type: regex regex: '"version":"([0-9.a-z\-]+)"' deployed_version: method: GET url: https://plex.example.io/identity headers: - key: X-Plex-Token value: <TOKEN> - key: Accept value: application/json json: MediaContainer.version dashboard: icon: https://www.plex.tv/wp-content/uploads/2023/03/plex-chevron.png web_url: https://forums.plex.tv/t/plex-media-server/30447

prometheus/alertmanager

Source: https://github.com/prometheus/alertmanager

service: prometheus/alertmanager: latest_version: type: github url: prometheus/alertmanager url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://alertmanager.example.io/api/v2/status json: versionInfo.version dashboard: web_url: https://github.com/prometheus/alertmanager/blob/main/CHANGELOG.md regex_content: alertmanager-{{ version }}\.linux-amd64.tar.gz

prometheus/prometheus

Source: https://github.com/prometheus/prometheus

service: prometheus/prometheus: latest_version: type: github url: prometheus/prometheus url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://prometheus.example.io/api/v1/status/buildinfo json: data.version dashboard: web_url: https://github.com/prometheus/prometheus/blob/main/CHANGELOG.md regex_content: prometheus-{{ version }}\.linux-amd64

Prowlarr/Prowlarr

Source: https://github.com/Prowlarr/Prowlarr

deployed_version - Requires an API_KEY which can be retrieved at Settings/General/Security/API Key

service: Prowlarr/Prowlarr: options: semantic_versioning: false latest_version: type: github url: Prowlarr/Prowlarr url_commands: - type: regex regex: v([0-9.]+)$ use_prerelease: true deployed_version: url: https://prowlarr.example.io/api/v1/system/status headers: - key: X-Api-Key value: <API_KEY> json: version dashboard: web_url: https://github.com/Prowlarr/Prowlarr/releases/v{{ version }} icon: https://avatars.githubusercontent.com/u/73049443?s=200&v=4

pterodactyl/panel

Source: https://github.com/pterodactyl/panel

service: pterodactyl/panel: latest_version: type: github url: pterodactyl/panel url_commands: - type: regex regex: v([0-9.]+) dashboard: web_url: https://github.com/pterodactyl/panel/releases/v{{ version }} icon: https://raw.githubusercontent.com/pterodactyl/panel/develop/public/assets/svgs/pterodactyl.svg

pterodactyl/wings

Source: https://github.com/pterodactyl/wings

deployed_version - Needs the node token which can be found in the admin GUI in the node configuration. (instructions)

service: pterodactyl/wings: latest_version: type: github url: pterodactyl/wings url_commands: - type: regex regex: v([0-9.]+) deployed_version: url: https://wings.example.io:8088/api/system headers: - key: Authorization value: Bearer <API Token> json: version dashboard: web_url: https://github.com/pterodactyl/wings/releases/v{{ version }} icon: https://raw.githubusercontent.com/pterodactyl/panel/develop/public/assets/svgs/pterodactyl.svg

qbittorrent/qBittorrent

Source: https://github.com/linuxserver/docker-qbittorrent

service: qbittorrent/qBittorrent: latest_version: type: github url: linuxserver/docker-qbittorrent url_commands: - type: regex regex: ^([0-9.]+)- require: docker: type: hub image: linuxserver/qbittorrent tag: '{{ version }}-libtorrentv1' deployed_version: type: url url: http://qbittorrent.example.com/api/v2/app/version regex: v?([0-9.]+) dashboard: icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/qbittorrent.png web_url: https://github.com/qbittorrent/qBittorrent/releases/tag/release-{{ version }}

Radarr/Radarr

Source: https://github.com/Radarr/Radarr

deployed_version - Requires an API_KEY which can be retrieved at Settings/General/Security/API Key

service: Radarr/Radarr: options: semantic_versioning: false latest_version: type: github url: Radarr/Radarr url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://radarr.example.io/api/v3/system/status headers: - key: X-Api-Key value: <API_KEY> json: version dashboard: web_url: https://github.com/Radarr/Radarr/releases/v{{ version }} icon: https://avatars.githubusercontent.com/u/25025331?s=200&v=4

rancher/rancher

Source: https://github.com/rancher/rancher

deployed_version - An API key must be created. This key is constructed in the format of <username>:<password>. (instructions)

service: rancher/rancher: latest_version: type: github url: rancher/rancher url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://rancher.example.io/v3/settings/server-version basic_auth: username: <username> password: <password> json: value regex: v([0-9.]+) dashboard: web_url: https://github.com/rancher/rancher/releases/v{{ version }} icon: https://raw.githubusercontent.com/rancher/docs/master/static/imgs/rancher-logo-cow-blue.svg

Readarr/Readarr

Source: https://github.com/Readarr/Readarr

deployed_version - Requires an API_KEY which can be retrieved at Settings/General/Security/API Key

service: Readarr/Readarr: options: semantic_versioning: false latest_version: type: github url: Readarr/Readarr use_prerelease: true url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://readarr.example.io/api/v1/system/status headers: - key: X-Api-Key value: <API_KEY> json: version dashboard: icon: https://raw.githubusercontent.com/Readarr/Readarr/develop/Logo/1024.png web_url: https://github.com/Readarr/Readarr/releases/v{{ version }}

release-argus/argus

Source: https://github.com/release-argus/Argus

service: release-argus/argus: latest_version: type: github url: release-argus/argus deployed_version: url: https://argus.example.io/api/v1/version json: version dashboard: web_url: https://github.com/release-argus/Argus/blob/master/CHANGELOG.md icon: https://github.com/release-argus/Argus/raw/master/web/ui/react-app/public/favicon.svg

requarks/wiki

Source: https://github.com/requarks/wiki

service: requarks/wiki: latest_version: type: github url: requarks/wiki url_commands: - type: regex regex: v([0-9.]+)$ require: regex_version: ^[0-9.]+$ deployed_version: url: https://wiki.example.io/graphql?query=%7Bsystem%7Binfo%7BcurrentVersion%7D%7D%7D headers: - key: Authorization value: Bearer <TOKEN> json: data.system.info.currentVersion dashboard: web_url: https://github.com/requarks/wiki/releases/tag/v{{ version }} icon: https://static.requarks.io/logo/wikijs-butterfly.svg

Mikrotik RouterOS

Needs a service account to check deployed_version. Add a new user with readonly permissions, limit their access to the IP of the server, and specify the credentials in the MIKROTIK_USER/MIKROTIK_PASSWORD environment variables.

service: routeros: options: semantic_versioning: true latest_version: type: url url: https://upgrade.mikrotik.com/routeros/NEWESTa7.stable url_commands: - type: regex regex: ^([0-9]+\.[0-9.]+) deployed_version: type: url url: http://192.168.1.1:8080/rest/system/resource json: version regex: "([0-9.]+)" basic_auth: username: ${MIKROTIK_USER} password: ${MIKROTIK_PASSWORD} dashboard: icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mikrotik.png web_url: https://mikrotik.com/download/changelogs?channelFilter=stable

sct/overseerr

Source: https://github.com/sct/overseerr

service: sct/overseerr: latest_version: type: github url: sct/overseerr url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://overseerr.example.io/api/v1/status json: version dashboard: icon: https://raw.githubusercontent.com/sct/overseerr/develop/public/android-chrome-512x512.png web_url: https://github.com/sct/overseerr/releases/v{{ version }}

smallstep/certificates

Source: https://github.com/smallstep/certificates

service: smallstep/certificates: latest_version: type: github url: smallstep/certificates url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://certificates.example.io/version json: version dashboard: web_url: https://github.com/smallstep/certificates/releases/tag/v{{ version }} icon: https://github.com/smallstep/docs/raw/main/static/graphics/logo-icon-white.svg

Sonarr/Sonarr

Source: https://github.com/Sonarr/Sonarr

deployed_version - Requires an API_KEY which can be retrieved at Settings/General/Security/API Key

service: Sonarr/Sonarr: options: semantic_versioning: false latest_version: type: url url: https://github.com/Sonarr/Sonarr/tags url_commands: - type: regex regex: \/releases\/tag\/v?([0-9.]+)\" deployed_version: url: https://sonarr.example.io/api/v3/system/status headers: - key: X-Api-Key value: <API_KEY> json: version dashboard: web_url: https://sonarr.example.io/system/updates icon: https://raw.githubusercontent.com/Sonarr/Sonarr/develop/Logo/256.png

Tautulli/Tautulli

Source: https://github.com/Tautulli/Tautulli

deployed_version - Requires API_KEY on the url, you can get it at Settings/Web Interface/API.

service: Tautulli/Tautulli: latest_version: type: github url: Tautulli/Tautulli url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://tautulli.example.io/api/v2?apikey=<API_KEY>&cmd=get_tautulli_info json: response.data.tautulli_version regex: v([0-9.]+)$ dashboard: icon: https://raw.githubusercontent.com/Tautulli/Tautulli/master/data/interfaces/default/images/logo-circle.png web_url: https://github.com/Tautulli/Tautulli/releases/tag/v{{ version}}

thanos-io/thanos

Source: https://github.com/thanos-io/thanos

service: thanos-io/thanos: latest_version: type: github url: thanos-io/thanos url_commands: - type: regex regex: v([0-9.]+)$ require: regex_content: thanos-{{ version }}\.linux-amd64 deployed_version: url: https://thanos.example.io/api/v1/status/buildinfo json: data.version dashboard: web_url: https://github.com/thanos-io/thanos/blob/main/CHANGELOG.md icon: https://github.com/thanos-io/thanos/blob/main/docs/img/Thanos-logo_fullmedium.png?raw=true

traccar/traccar

Source: https://github.com/traccar/traccar

service: traccar/traccar: options: semantic_versioning: false latest_version: type: github url: traccar/traccar url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://traccar.example.io/api/server json: version dashboard: icon: https://raw.githubusercontent.com/traccar/traccar-web/master/public/logo.svg web_url: https://www.traccar.org/blog/traccar-{{ version | split:"." | join:"-" }}/

usememos/memos

Source: https://github.com/usememos/memos

service: usememos/memos: latest_version: type: github url: usememos/memos url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: method: GET url: https://memos.example.io/api/v1/workspace/profile json: version dashboard: icon: https://raw.githubusercontent.com/usememos/memos/main/web/public/logo.webp web_url: https://github.com/usememos/memos/releases/tag/v{{ version }}

vector-im/element-web

Source: https://github.com/vector-im/element-web

service: vector-im/element-web: latest_version: type: github url: vector-im/element-web url_commands: - type: regex regex: v([0-9.]+)$ deployed_version: url: https://element.example.io/version dashboard: web_url: https://github.com/vector-im/element-web/releases/tag/v{{ version }} icon: https://github.com/vector-im/element-web/raw/develop/res/vector-icons/150.png

wekan/wekan

Source: https://github.com/wekan/wekan

service: wekan/wekan: options: semantic_versioning: false latest_version: type: github url: wekan/wekan url_commands: - type: regex regex: v([0-9.]+)$ require: regex_version: ^[0-9.]+$ dashboard: web_url: https://github.com/wekan/wekan/releases/tag/v{{ version }} icon: https://raw.githubusercontent.com/wekan/wekan/df54863e7243b0b067ec2d30d8352ff1838931c4/meta/icons/wekan-150.svg

wordpress/wordpress

Source: https://github.com/WordPress/WordPress

service: wordpress/wordpress: latest_version: type: url url: https://github.com/wordpress/wordpress/tags url_commands: - type: regex regex: \/releases\/tag\/([0-9.]+)\" deployed_version: url: https://wordpress.example.io/feed/ regex: '<generator>https:\/\/wordpress\.org\/\?v=([0-9.]*)\<\/generator\>' dashboard: web_url: https://wordpress.org/news/category/releases/ icon: https://github.com/WordPress/WordPress/raw/master/wp-admin/images/wordpress-logo.svg

wowchemy/wowchemy-hugo-themes

Source: https://github.com/wowchemy/wowchemy-hugo-themes

service: wowchemy/wowchemy-hugo-themes: latest_version: type: github url: wowchemy/wowchemy-hugo-themes url_commands: - type: regex regex: v([0-9.]+)$ dashboard: web_url: https://github.com/wowchemy/wowchemy-hugo-themes/releases/v{{ version }}

Last modified February 8, 2026: fixed path & RE for qBt (de724e5)