A highly customizable homepage (or startpage / application dashboard) with Docker and service API integrations.
Find a file
2022-08-25 11:17:41 +03:00
.github/workflows Create docker-publish.yml 2022-08-24 10:48:42 +03:00
images add preview image 2022-08-25 03:34:20 +03:00
public update favicon 2022-08-25 01:33:48 +03:00
src add theme switcher 2022-08-25 11:14:17 +03:00
.dockerignore first public source commit 2022-08-24 10:44:35 +03:00
.editorconfig first public source commit 2022-08-24 10:44:35 +03:00
.eslintrc.json Initial commit from Create Next App 2022-08-24 10:34:08 +03:00
.gitignore first public source commit 2022-08-24 10:44:35 +03:00
Dockerfile use a custom https agent for self-signed bypass 2022-08-25 01:33:39 +03:00
jsconfig.json first public source commit 2022-08-24 10:44:35 +03:00
LICENSE Initial commit 2022-08-24 10:29:42 +03:00
next.config.js first public source commit 2022-08-24 10:44:35 +03:00
package.json add nzbget service widget 2022-08-25 02:48:52 +03:00
pnpm-lock.yaml add nzbget service widget 2022-08-25 02:48:52 +03:00
postcss.config.js first public source commit 2022-08-24 10:44:35 +03:00
README.md add features to readme 2022-08-25 11:17:41 +03:00
tailwind.config.js add theme switcher 2022-08-25 11:14:17 +03:00

Homepage Preview

Features

  • Web Bookmarks
  • Service Bookmarks
    • Docker Integration
      • Status light + CPU, Memory & Network Reporting
    • Service Integration
      • Currently supports Sonarr, Radarr, Ombi, Emby, NZBGet & Portainer
  • Homepage Widgets
    • System Stats (Disk, CPU, Memory)
    • Weather (via weatherapi.com)
  • Customizable
    • 21 theme colors with light and dark mode support

Getting Started

Using docker compose:

version: '3.3'
services:
    homepage:
        image: ghcr.io/benphelps/homepage:main
        container_name: homepage
        ports:
            - 3000:3000
        volumes:
            - /path/to/config:/app/config

or docker run:

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

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.

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.