Apps

An app is a saved shortcut used by the App and Bookmarks widgets. It contains a name, destination, icon, and optional status-check address.

The Apps management page

How an app is used

App recordSaved once in Homarr

NameIconURLPing URL · optional

place

BoardApp tile or Bookmarks widget

click

BrowserOpens the app URL directly

If a Ping URL is set, the Homarr server checks that address for status. Clicking the tile still opens the app URL.

Create and manage apps under Management → Apps.

Field	Purpose
Name	Label shown on the board
Icon URL	Direct image URL, icon-library result, or uploaded image
Description	Optional tooltip
URL	Destination opened from the board; custom URI schemes are supported except `javascript:`
Ping URL	Optional HTTP(S) address used for status checks when it differs from the destination

An app can be linked to an integration. Integration widgets then use the app as their destination when they provide a link to the service.

See Icons for icon sources and uploads.

app-create creates apps.
app-modify-all lists and edits every app.
app-full-all also deletes and uses every app.
app-use-all allows using every app on boards without granting management access.

Users with only app-create can open the page and create an app, but do not receive the existing app list.