oak logo

oak

A simple homepage for self-hosters.

Website GitHub

What is it?

What it is

A self-hosted startpage/homepage for navigating self-hosted applications, managing bookmarks, and displaying optional widgets such as greetings, quotes, and weather.

Why it exists

To give self-hosters an opinionated, fully customizable, mobile‑friendly dashboard inspired by Flame and SUI, with easy theming, search, and migration tools.

Who should use it

Self-hosters and developers looking for a customizable, mobile-friendly start page that integrates with their own applications and bookmarks.

Who should avoid it

Users who need a public-facing homepage, non-technical users, or those who prefer a fully managed SaaS solution without self-hosting responsibilities.

How it works

A quick walkthrough in plain English

How oak works

Step 1 of 3

You interact with it

Open oak, send a request, or connect it to your stack.

Features

Quick navigation of self‑hosted applications with icon support
Optional bookmarks organized by categories
Optional greetings and daily quotes
Optional local weather widget
Fully customizable themes and theme builder
Global search for apps/bookmarks with configurable hotkey and engine
Built‑in migration tool from Flame
Docker and Unraid ready deployment
Mobile‑friendly UI
Icons adapt color to theme
No login required (self‑hosted only)

Advantages

  • Easy to set up and use
  • Highly customizable with theme builder
  • Supports a wide range of self‑hosted services
  • Built‑in search speeds up access
  • Docker/Unraid support simplifies deployment
  • Open source and free
  • Mobile‑friendly design
  • Icons automatically match theme color
  • Migration from existing Flame setup is straightforward

Disadvantages

  • Not intended for public hosting – no authentication
  • Limited to self‑hosted environments only
  • Relies on SQLite for storage – may not scale for large deployments
  • Opinionated design may reduce flexibility for some users
  • Requires Docker/Unraid setup for some users
  • No built‑in analytics or usage tracking
  • No native support for multi‑user accounts

Installation

docker

docker run -d -it -p 3000:80 -v /path/on/host:/rails/storage ghcr.io/bert-mccutchen/oak:latest

FAQ

How do I set up Oak using Docker?

Run the Docker command provided in the README, mounting your desired database storage path to `/rails/storage` (e.g., `docker run -d -it -p 3000:80 -v /path/on/host:/rails/storage ghcr.io/bert-mccutchen/oak:latest`).

Can I customize the themes?

Yes, you can create your own themes using the custom theme builder, clone existing themes, or tweak them as needed.

What optional features are available?

Optional features include greetings, daily quotes, local weather, and web search (via tab from global search).

How do I migrate from Flame to Oak?

Use the built-in import utility provided in Oak to transfer data from Flame.

Why is Oak not intended for public hosting?

Oak is designed for self-hosted use and should not be exposed to the public internet for security reasons.

Is Oak mobile-friendly?

Yes, Oak includes mobile-optimized screenshots and themes for seamless use on mobile devices.

Loading documentation…
View on GitHub

Featured in Videos

YouTube tutorials and walkthroughs for oak

Alternatives

Similar projects ranked by category, topics, and text overlap.

Compare
oak | MushyBook