---

name: homepage-settings description: Configure settings.yaml for Homepage dashboard - theme, layout, providers, quick launch, and global options license: MIT compatibility: opencode metadata: project: homepage type: yaml-config

Homepage settings.yaml Configuration

Reference for application-level settings.

Structure

Copy---
title: My Homepage
theme: dark
layout:
  GroupName:
    style: row
    columns: 4

Title & Branding

Theme & Appearance

Background

Copybackground:
  image: /images/background.png
  blur: sm
  saturate: 50
  brightness: 50
  opacity: 50

Note: Restart container when adding new images.

Layout

Copylayout:
  Media:
    style: row
    columns: 4
    header: false
    initiallyCollapsed: true
    useEqualHeights: true
    icon: jellyfin.png

Tabs

Copylayout:
  Media:
    tab: First
    style: row
    columns: 4
  Downloads:
    tab: First
  Monitoring:
    tab: Second
  Always Visible:
    style: row # No tab = all tabs

Layout Behavior

Providers

Define shared API credentials:

Copyproviders:
  openweathermap: your-api-key
  longhorn:
    url: https://longhorn.example.com
    username: admin
    password: LonghornPassword

Use in widgets:

Copy- openweathermap:
    provider: openweathermap # Instead of apiKey
    latitude: 50.449684
    longitude: 30.525026

Quick Launch

Copyquicklaunch:
  searchDescriptions: true
  hideInternetSearch: false
  showSearchSuggestions: true
  provider: google # duckduckgo, bing, baidu, brave, custom

Custom provider:

Copyquicklaunch:
  provider: custom
  url: https://www.ecosia.org/search?q=
  suggestionUrl: https://ac.ecosia.org/autocomplete?type=list&q=

Global Options

Complete Example

Copy---
title: My Dashboard
theme: dark
color: slate
headerStyle: boxed
useEqualHeights: true

layout:
  Media:
    style: row
    columns: 4
    icon: jellyfin.png
  Monitoring:
    style: row
    columns: 3
    initiallyCollapsed: true

providers:
  openweathermap: { { HOMEPAGE_VAR_WEATHER_KEY } }

quicklaunch:
  searchDescriptions: true
  provider: duckduckgo

target: _blank
showStats: true
statusStyle: dot