richardthornton/clickshift

ClickShift

A minimal, self-hosted bookmark start page.

https://img.shields.io/badge/GitHub-richardthornton%2Fclickshift-blue](https://github.com/richardthornton/clickshift)

Quick Start

bash
docker run -d \
  -p 8080:8080 \
  -v clickshift-data:/data \
  -e CLICKSHIFT_USER=admin \
  -e CLICKSHIFT_PASS=your-secure-password \
  richardthornton/clickshift

Open http://localhost:8080 and login with admin / your-secure-password.

Why ClickShift?

• Tiny footprint - Under 10MB image, minimal CPU and memory usage
• No database - Bookmarks stored in a single JSON file
• Zero dependencies - Single ***ary, scratch-based container
• Clean interface - Responsive grid with 6 color themes and light/dark mode
• Drag-and-drop - Easily reorder bookmarks and categories
• Simple auth - Password protection with rate limiting
• Optional read-lock - Set CLICKSHIFT_LOCK to hide bookmarks behind a shared password

Perfect for homelabs, personal servers, or anyone who wants a clean browser start page.

Docker Compose

yaml
services:
  clickshift:
    image: richardthornton/clickshift
    ports:
      - "8080:8080"
    environment:
      - CLICKSHIFT_USER=admin
      - CLICKSHIFT_PASS=your-secure-password
    volumes:
      - clickshift-data:/data
    restart: unless-stopped

volumes:
  clickshift-data:

Configuration

Volumes

Ports

Shared Read-Lock

Set CLICKSHIFT_LOCK to gate all read access behind a password:

yaml
environment:
  - CLICKSHIFT_USER=admin
  - CLICKSHIFT_PASS=your-secure-password
  - CLICKSHIFT_LOCK=shared-family-password

Visitors see only a password field on first load — bookmarks and the admin login are never sent to the browser until the correct password is entered. The unlock is stored in an HttpOnly cookie for the session duration. A lock icon in the bottom-right lets anyone re-lock on demand. Unlock atte***s are rate-limited (5 per IP per 15 minutes). Leave the variable unset to disable.

Themes

6 built-in color themes included: Default, ***ized, Dracula, Nord, Tokyo Night, and Matcha. Each theme has light and dark variants.

To add custom themes, mount a folder containing JSON theme files:

yaml
volumes:
  - ./my-themes:/themes

Theme JSON format (e.g., ocean.json):

json
{
  "id": "ocean",
  "name": "Ocean",
  "light": {
    "background": "#f0f5f9",
    "text": "#3d5a6c",
    "heading": "#1a3a4a"
  },
  "dark": {
    "background": "#0d1b2a",
    "text": "#7eb8da",
    "heading": "#00d4ff"
  }
}

Tags

• latest - Latest stable release
• x.y.z - Specific version

Source

https://github.com/richardthornton/clickshift

License

MIT