Apps Widget

Displays a configurable grid of app shortcuts with icons and names. Useful as a quick-launch panel for self-hosted services or any web app — local or external.

Configuration

No API key required. All configuration is done in Settings → Widgets → Apps.

Key	Type	Default	Description
apps	AppEntry[]	[]	List of apps to display
columns	number	4	Number of grid columns (2–6)
hideHeader	boolean	false	Hide the widget title bar
defaultCollapsed	boolean	false	Start collapsed

App entry fields

Field	Type	Description
name	string	Display name shown below the icon
url	string	Link target (local or external URL)
description	string	Optional tooltip text shown on hover
iconValue	string	Icon URL (preset CDN, uploaded file, or any URL)
openInNewTab	boolean	Open link in a new browser tab

Adding apps

1. Open Settings → Widgets and click the configure (gear) icon on the Apps widget.
2. Fill in the Name and URL fields (required).
3. Optionally add a Description (shown as a tooltip on hover).
4. Choose an icon:
   • Preset — searchable list of ~60 popular self-hosted services using the selfh.st/icons library.
   • URL — paste any image URL directly.
   • Upload — upload a local image file (PNG, JPG, GIF, SVG, WebP, ICO). The file is stored in data/icons/ on the server.
5. Click Add App, then Save Changes.

Icon sources

Preset icons are fetched from the selfh.st CDN at:

https://cdn.jsdelivr.net/gh/selfhst/icons/png/{service-name}.png

Uploaded icons are served by the server at /api/icons/{filename} and stored in data/icons/.

Notes

• Apps can link to external URLs — there is no requirement that the app be on the same server.
• The widget displays apps in the order they were added. To reorder, remove and re-add.
• If a preset icon fails to load (network issue or unknown slug), it falls back to a placeholder icon.