Advanced configuration
Configure deployment, authentication, networking, styling, automation, and development workflows.
These guides cover changes that affect how Homarr is deployed, secured, operated, or extended.
Dashboard data cache
Homarr keeps eligible integration responses in Redis. It also retains a bounded, board-scoped snapshot of selected integration widget queries for up to three days. Authorized viewers receive the last snapshot while the server refreshes those queries and streams updated values to the browser. Embedded images and large results are excluded. The browser keeps TanStack Query data in memory only; dashboard query data is not saved in browser storage.
Deploy and secure
Environment variables
Configure Homarr at deployment time.
Single sign-on
Connect an external identity provider.
Proxies and certificates
Run Homarr behind a reverse proxy.
Run as a different user
Change the user and group used by the container.
Customize
Custom styling
Apply custom CSS to Homarr.
Icons
Configure icon sources and behavior.
Keyboard shortcuts
Navigate and operate Homarr with the keyboard.