Congratulations! You've installed Homarr. Now, it's time to configure it to your liking. This guide will help you get started with Homarr.
Adding your first app
Let's begin by adding your first app to Homarr. Enter Edit Mode and click on the Add a Tile button:
A popup will appear, where you can choose the type of tile you want to add. For now, we'll choose "Apps":
Another popup will appear, where you can enter the details of your app. You can also choose an icon for your app:
The following fields are required:
- App Name
- Internal address
- App Icon (Will be automatically grabbed if possible.)
Entering Edit Mode
You can adjust your dashboard by going into ✨ Edit Mode ✨. In Edit Mode, you can move, edit and delete tiles.
You can enter Edit Mode using this button, which is located at the top right of your screen:
When you enter Edit Mode, you will see a few changes:
- Tiles will have their own menu, where you can make changes to them.
- A "Add a Tile" button will appear next to the "Edit Mode" button.
- A popup will appear on the bottom left of the screen with some useful information.
Changes are only saved when you exit Edit Mode. If you leave the page without exiting Edit Mode, your changes will be lost.
Organizing and re-arranging your dashboard
After you've added a few apps, it's time to organize and re-arrange your dashboard. While Edit Mode is active, the following changes will be made to the tiles.
- A menu will appear on the top right of the tile. This menu can be used to edit or delete the tile.
- A resize arrow will appear on the bottom right of the tile. Click (hold) and drag to resize the tile.
- Tiles are movable. Click (hold) and drag to move the tile.
You can add categories to your dashboard. Categories are useful for organizing your apps. Click the "Add a new tile" button and choose "Category":
Tiles can be organized into categories. Simply drag and drop the tile into the category.
Each category will have it's own menu, allowing you to change it's position and name, to delete it, or to add a new category below/above.
You can further extend the functionality of your dashboard by adding widgets. Widgets are used to display information from your apps. For example, you can add a widget that displays the current weather. Widgets can also be interactive, allowing you to control external apps or services from your dashboard.
Click the "Add a new tile" button and choose "Widget":
Click on the widget you want to add. You can choose from a variety of widgets:
Wigets can be organized the same way as apps can be. Please note that some widgets require additional configuration before they can be used.
Integrations are configured using the "Integration" tab when Editing/Adding a widget. You can choose from a variety of integrations.
After choosing an integration type, you can configure the integration. For example, if you choose the "Weather" integration, you will be able to configure the location of the weather widget.
Two types of values are used.
public. Public values should not contain passwords or tokens, as they are being sent to the client. Private values will only be sent one time, and will never be used after exiting Edit Mode. For this reason, you won't be able to read the values of your private credentials after setting them.
The Homarr Team will never ask for your credentials. Do not send people your credentials, as they manage the access to your applications and can cause harm to your device if they are abused.