---
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]]