A highly customizable homepage (or startpage / application dashboard) with Docker and service API integrations.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
Anonymous f9886f7c63
Translated using Weblate (Chinese (Simplified))
2 years ago
.github Delete linter.yml 2 years ago
images add preview image 2 years ago
public Translated using Weblate (Chinese (Simplified)) 2 years ago
src implement weather geolocation 2 years ago
.babelrc forcefully disable next-swc 2 years ago
.dockerignore first public source commit 2 years ago
.editorconfig first public source commit 2 years ago
.eslintrc.json linting and cleanup 2 years ago
.gitignore first public source commit 2 years ago
Dockerfile fix build 2 years ago
LICENSE Initial commit 2 years ago
README.md update readme 2 years ago
jsconfig.json first public source commit 2 years ago
next.config.js forcefully disable next-swc 2 years ago
package.json implement i18n 2 years ago
pnpm-lock.yaml implement i18n 2 years ago
postcss.config.js first public source commit 2 years ago
tailwind.config.js add theme switcher 2 years ago

README.md

Homepage Preview

Docker Weblate

Features

  • Fast! The entire site is statically generated at build time, so you can expect instant load times.
  • Full i18n support with automatic language detection.
  • Complete Docker support, including AMD64, ARM64, ARMv7 and ARMv6 support (schklom and modem7)
  • Service & Web Bookmarks
  • Docker Integration
    • Status light + CPU, Memory & Network Reporting (click on the status light)
  • Service Integration
    • Currently supports Sonarr, Radarr, Ombi, Emby, Jellyfin, Tautulli (Plex), Jellyseerr (ilusi0n), NZBGet, ruTorrent
    • Portainer, Traefik, Speedtest Tracker, PiHole, Nginx Proxy Manager (aidenpwnz)
  • Information & Utility Widgets
    • System Stats (Disk, CPU, Memory)
    • Weather via WeatherAPI.com or OpenWeatherMap (AlexFullmoon)
    • Search Bar (aidenpwnz)
  • Customizable
    • 21 theme colors with light and dark mode support
    • Background image support

Support & Suggestions

If you have any questions, suggestions, or general issues, please start a discussion on the Discussions page.

If you have a more specific issue, please open an issue on the Issues page.

Getting Started

For configuration options, examples and more, please check out the Wiki.

With Docker

Using docker compose:

version: '3.3'
services:
    homepage:
        image: ghcr.io/benphelps/homepage:latest
        container_name: homepage
        ports:
            - 3000:3000
        volumes:
            - /path/to/config:/app/config
            - /var/run/docker.sock:/var/run/docker.sock # (optional) For docker integrations

or docker run:

docker run -p 3000:3000 -v /path/to/config:/app/config -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/benphelps/homepage:latest

With Node

First, clone the repository:

git clone https://github.com/benphelps/homepage.git

Then install dependencies and build the production bundle (I'm using pnpm here, you can use npm or yarn if you like):

pnpm install
pnpm build

Finally, run the server:

pnpm start

Configuration

Configuration files will be genereted and placed on the first request.

Configuration is done in the /config directory using .yaml files. Refer to each config for the specific configuration options.

You may also check the wiki for detailed configuration instructions, examples and more.

Development

Install NPM packages, this project uses pnpm (and so should you!):

pnpm install

Start the development server:

pnpm dev

Open http://localhost:3000 to start.

This is a Next.js application, see their doucmentation for more information: