Skills2026年4月16日·1 分钟阅读

Homepage — Highly Customizable Self-Hosted Dashboard

Homepage is a modern, fully customizable application dashboard and startpage. It integrates with 100+ services to display real-time status, weather, bookmarks, and widgets — all configured through simple YAML files.

Agent 就绪

Agent 可直接安装

这个资产可安装;Agent 先选择当前运行时、检查安装计划,再运行匹配命令。

Native · 98/100策略:允许
Agent 入口
任意 MCP/CLI Agent
类型
Skill
安装
Single
信任
信任等级:Established
入口
Homepage Overview
直接安装命令
npx -y tokrepo@latest install 194a3a23-39db-11f1-9bc6-00163e2b0d79 --target codex

先 dry-run 确认安装计划,再运行此命令。

TL;DR
Homepage gives you a self-hosted dashboard with 100+ service integrations via YAML config.
§01

What it is

Homepage is a modern, fully customizable application dashboard and startpage. It integrates with 100+ services to display real-time status, weather, bookmarks, and widgets, all configured through simple YAML files. It serves as a central hub for your self-hosted services, showing at a glance whether everything is running.

Homepage targets homelab operators and self-hosters who run multiple services and need a single page to monitor and access them. Instead of bookmarking 20 different URLs, you have one dashboard that shows the status of each service.

§02

Why it saves time or tokens

Checking the status of multiple self-hosted services means opening each one individually. Homepage shows all services on one page with live status indicators, resource usage, and quick links. The YAML configuration is simple enough that AI assistants can generate service entries accurately, and adding a new service takes one YAML block.

§03

How to use

  1. Deploy Homepage with Docker: docker run -p 3000:3000 -v ./config:/app/config ghcr.io/gethomepage/homepage
  2. Edit services.yaml to add your services with URLs and API keys
  3. Configure widgets.yaml for weather, search, and system info widgets
§04

Example

# services.yaml
- Media:
    - Plex:
        icon: plex.svg
        href: https://plex.example.com
        description: Media Server
        widget:
          type: plex
          url: http://plex:32400
          key: your-plex-token
    - Navidrome:
        icon: navidrome.svg
        href: https://music.example.com
        description: Music Server

- Infrastructure:
    - Proxmox:
        icon: proxmox.svg
        href: https://proxmox.example.com
        widget:
          type: proxmox
          url: https://proxmox:8006
          username: api-user
          password: api-token
Widget TypeData Shown
Service statusUp/down indicator
Plex/JellyfinActive streams, library size
DockerContainer count, status
SystemCPU, memory, disk usage
WeatherCurrent conditions, forecast
§05

Related on TokRepo

§06

Common pitfalls

  • Service widgets require API keys or tokens for each service; gathering these takes time during initial setup
  • YAML indentation errors cause the entire config to fail; use a YAML validator before restarting
  • Homepage makes HTTP requests to each service for status; services behind authentication may require dedicated API tokens

常见问题

What services does Homepage integrate with?+

Homepage integrates with over 100 services including Plex, Jellyfin, Sonarr, Radarr, Pi-hole, AdGuard, Proxmox, Portainer, Traefik, Nginx Proxy Manager, and many more. Each integration provides a widget showing service-specific data like active streams, download status, or system metrics.

How does Homepage compare to Homarr or Dashy?+

All three are self-hosted dashboards. Homepage uses YAML configuration and focuses on service widgets. Homarr has a drag-and-drop UI editor. Dashy offers the most customization options with themes and layouts. Homepage is the simplest to configure for users comfortable with YAML.

Can Homepage show Docker container status?+

Yes. Homepage has a Docker integration that shows container status, health, and resource usage. You can configure it to auto-discover containers by label, so new containers appear on the dashboard automatically without editing YAML.

Does Homepage support authentication?+

Homepage itself does not have built-in authentication. For public-facing deployments, place it behind a reverse proxy with authentication (Authentik, Authelia, or basic auth). For local network use, most homelab operators run it without auth.

Can I customize the appearance?+

Yes. Homepage supports custom CSS, multiple color themes (light/dark), custom backgrounds, and layout options. You configure appearance in settings.yaml. The design is modern and responsive, working well on both desktop and mobile browsers.

引用来源 (3)

讨论

登录后参与讨论。
还没有评论,来写第一条吧。

相关资产