51 lines
No EOL
1.8 KiB
Markdown
51 lines
No EOL
1.8 KiB
Markdown
---
|
|
title: "Homarr documentation"
|
|
source: "https://homarr.dev/docs/management/apps/"
|
|
author:
|
|
published:
|
|
created: 2026-04-19
|
|
description: "Apps are the building blocks of your Homarr board."
|
|
tags:
|
|
- "clippings"
|
|
---
|
|
Version: 1.59.2
|
|
|
|
Apps are the building blocks of your Homarr board. Most of the time they are a simple link to a website, but used on your board they also support a simple ping to check if your service is up. Apps are used in the bookmark and app widget.
|
|
|
|
## Create an app
|
|
|
|
To create an app you can click on the button on the top right of the apps management page:
|
|
|
|
![[881d180a726437fe08748cfbe467767d_MD5.png]]
|
|
|
|
Next, you'll need to fill out the required fields to configure the app:
|
|
|
|
![[9008c71880a52ee44f44d3f211f238cc_MD5.png]]
|
|
|
|
### Name
|
|
|
|
The name must be at least one character long and can be chosen freely.
|
|
|
|
### Icon URL
|
|
|
|
This is the URL to the icon that will be displayed on the app widget. It can be a url to an image in the internet, one from the included icon repositories or a local file uploaded through the upload button.
|
|
|
|
![[bc56e670b2dfd62977a82e503178a9fe_MD5.png]]
|
|
|
|
### Description
|
|
|
|
An optional description that can be shown as tooltip on the app widget.
|
|
|
|
### URL
|
|
|
|
The URL to the website you want to link to. Clicking on the app widget or bookmark will open this URL.
|
|
|
|
### Ping URL
|
|
|
|
When you want to use another url for the simple status check you can set it here. This will allow you to set a different URL for the ping than the URL that is opened when clicking on the app widget. It's useful when you want to ping the service internally for example with a custom ip but open the website externally.
|
|
|
|
## List of apps
|
|
|
|
On the apps management page you find all apps that exist in your Homarr instance. You can edit and delete them.
|
|
|
|
![[57882a4a4257df5162df73d51af51217_MD5.png]] |