Homepage

One tidy start page for your home, with links, weather and live status from your apps.

Food & home GPL-3.0-only

What it does

Homepage is a start page for your browser or a wall tablet. It gathers the links your household uses into tidy, labelled tiles, with the weather, the date, a search box and live numbers from your home apps, such as tonight's meal from Mealie or how many photos are in Immich. You set it up by editing a few simple text files, so an AI can write them for you. It runs on your own computer and keeps your app passwords out of the browser.

  • All your links and home apps on one tidy page
  • Live numbers from 150+ apps, plus weather, clock and search
  • Set up with simple text files that an AI can write for you
  • Themes, background photos, tabs and 40+ languages

Great for: Households with a home server or a few self-hosted apps who want one friendly page to start from.

  • LicenceGPL-3.0-only
  • Where it runsOnline (about $5/month, usage-based) · Your computer (free)
  • Built withjavascript, yaml, css
  • Your dataNone stored
  • Sourcegethomepage/homepage

Ways to use it

Choose one when you tell your AI. It sets everything up with you, in plain words.

  • Online with Railway about $5/month, usage-basedA general-purpose host that can run any of these apps, including your own customised version. Usage-based pricing with a free trial. Third-party host.
  • On my own computerFreeYour AI installs what it needs and explains each step. It works while your computer is on.

Homepage has no login by default: keep it private, or ask your AI to add a password before putting it online.

Hosts are independent companies, not BespokeAI. You sign up and pay them directly. We may earn a referral fee, which never changes your price.

How people are using this project

Examples of what people ask their AI to do with Homepage. Start from one, or just tell your AI and it will ask what you'd like.

Can I trust it?

  • GPL-3.0-only. Free to use and change. If you give a changed copy to other people, you must share your source code under the same licence. Running it for yourself or your household has no extra obligations.
  • Your data: stores no personal data. YAML files plus custom.css and custom.js in the config folder (/app/config in Docker). No database.
  • Other services: Your other self-hosted apps (Home Assistant, Mealie, Immich, Paperless and 150+ more) (optional, free); Weather providers (Open-Meteo, OpenWeatherMap, WeatherAPI) (optional, free (Open-Meteo needs no key)); OIDC sign-in provider (Authentik, Authelia, Keycloak…) (optional, free (self-hosted) or varies)
  • Pinned version 44bf8c1. Every handover uses exactly this code, which we've reviewed.
  • Homepage has no login unless you turn one on. Keep it on your home network, or put it behind a reverse proxy with HTTPS and HOMEPAGE_AUTH_ENABLED.
  • The config folder holds API keys for your other apps. Never paste it, or HOMEPAGE_* secrets, into an AI chat; share it with keys removed.
  • Mounting the Docker socket gives Homepage a lot of power over your server. Use it read-only, or a socket proxy, or leave it out.
  • The optional MCP endpoint can read every key in your config and, with writes on, change custom.js. Only enable it with a long token and on a trusted network.

Did it work for people?

No reports yet

Be the first to tell others how it went.

Tell us how it went

Run your lights, heating and smart gadgets from one private app, with easy routines.

Food & home

Your family's recipes, weekly meal plan and shopping list in one place.

Food & home

Scan your household paperwork once and find any letter, bill or receipt in seconds.

Food & home