jordanroher/starbase-80 repository overview

⁠Starbase 80

⁠About

A nice looking homepage for Docker containers or any services and links.

No actual integration with Docker. Loads instantly. Dark mode follows your OS.

If you make a change to the config JSON, restart this container and refresh.

Inspired by Ben Phelps' Homepage⁠ and Umbrel⁠. Dedicated to Star Trek: Lower Decks⁠.

⁠Docker and source code

• Docker image⁠
• Source code on GitHub⁠

⁠Live demo

• Starbase 80⁠

⁠Preview

⁠Change history

⁠1.6.1

• Added iconBubblePadding boolean option to categories and services

⁠1.6.0

• Added CATEGORYBUBBLECOLORLIGHT and CATEGORYBUBBLECOLORDARK for greater control of category bubble colors
• Added category.bubbleBGLight and category.bubbleBGDark to theme individual category bubble background colors

⁠1.5.5

• Updated to node:23-slim

⁠1.5.4

• Re-added wget to allow for health checks

⁠1.5.3

• Added support for selfh.st⁠ icons

⁠1.5.2

• Fixed issue with Material icons having incorrect left margin
• Fixed aspect ratio issues on images

⁠1.5.1

• Changed links to be on the entire service object
• Added underline option

⁠1.5.0

• Fixed dark mode manual override

⁠1.4.2

• Added apple-touch-icon-precomposed link

⁠1.4.0

• Rewrote the entire application to not use React. Now it's just a Node application that emits static HTML.
• Removed lots of packages

⁠1.3.0

• Removed all JavaScript as part of the build step. The image will be slightly larger and take longer to start up and shut down, but the page will be even lighter.

⁠1.2.0

• Moved config.json bind mount destination to /app/src/config/config.json for improved Portainer and volume support. The previous bind mount location will continue to work, but we recommend updating your bind mounts.

⁠Docker

⁠Sample Docker compose

services:
    starbase80:
        image: jordanroher/starbase-80
        ports:
            - 80:4173
        environment:
            - TITLE=Starbase 80
            - LOGO=/starbase80.jpg
        volumes:
            - ./config.json:/app/src/config/config.json
            - ./public/favicon.ico:/app/public/favicon.ico
            - ./public/logo.png:/app/public/logo.png
            - ./public/icons:/app/public/icons

⁠Environment variables

⁠Volumes (bind mounts)

⁠Configuration

⁠Sample config.json

[
	{
		"category": "Services",
		"services": [
			{
				"name": "Archivebox",
				"uri": "https://archivebox.mywebsite.com",
				"description": "Backup webpages",
				"icon": "/icons/archivebox.jpg"
			},
			{
				"name": "Authelia",
				"uri": "https://auth.mywebsite.com",
				"description": "Authentication",
				"icon": "selfhst-authelia"
			},
			{
				"name": "Calibre",
				"uri": "https://calibre.mywebsite.com",
				"description": "eBook library",
				"icon": "/icons/calibre.png"
			}
		]
	},
	{
		"category": "Devices",
		"bubble": true,
		"services": [
			{
				"name": "Router",
				"uri": "http://192.168.1.1/",
				"description": "Netgear Orbi",
				"icon": "/icons/router.png"
			},
			{
				"name": "Home Assistant",
				"uri": "http://homeassistant.local:8123/",
				"description": "Home automation",
				"icon": "home-assistant",
				"iconBubble": false
			},
			{
				"name": "Synology",
				"uri": "http://synology:5000",
				"description": "Network storage",
				"icon": "/icons/synology.png"
			}
		]
	}
]

⁠Category variables

⁠Service variables

⁠Icons

⁠Volume / bind mount

Create a volume or bind mount to a subfolder of /app/public and specify a relative path.

# Your folder
compose.yml
- icons
  - jellyfin.jpg
  - ghost.jpg
  - etc

# Bind mount
./icons:/app/public/icons

# Icon in config.json
"icon": "/icons/jellyfin.jpg"

⁠Dashboard icons

Use Dashboard icons⁠ by specifying a name without any prefix.

# Icon in config.json
"icon": "jellyfin"

⁠Material design

Use any Material Design icon⁠ by prefixing the name with mdi-.

Fill the icon by providing an "iconColor."

Use "black" or "white" for those colors.

# Icon in config.json
"icon": "mdi-cloud",
"iconColor": "black"

⁠Selfh.st icons

Use any selfh.st icon⁠ by prefixing the name with selfhst-.

# Icon in config.json
"icon": "selfhst-couchdb"