https://github.com/bert-mccutchen/oak
A simple homepage for self-hosters.
https://github.com/bert-mccutchen/oak
homepage self-hosted startpage theming wisdom
Last synced: 3 months ago
JSON representation
A simple homepage for self-hosters.
- Host: GitHub
- URL: https://github.com/bert-mccutchen/oak
- Owner: bert-mccutchen
- Created: 2025-12-24T18:07:20.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-11T01:39:51.000Z (5 months ago)
- Last Synced: 2026-01-11T06:48:38.001Z (5 months ago)
- Topics: homepage, self-hosted, startpage, theming, wisdom
- Language: JavaScript
- Homepage: https://bertm.dev
- Size: 14.1 MB
- Stars: 43
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
A simple homepage for self-hosters.
_100% opinionated — based on [Flame](https://github.com/pawelmalak/flame) and [SUI](https://github.com/jeroenpardon/sui). Fork or make your own if you want something different._
## Features
- Quickly navigate your self-hosted applications.
- Icons from [selfh.st/icons](https://github.com/selfhst/icons).
- Icons change color with your theme.
- Keep common bookmarks handy. (optional)
- Organize them with categories.
- Greetings for good vibes. (optional)
- Daily quotes for extra wisdom. (optional)
- Local weather conditions. (optional)
- Completely customizable.
- 100% mobile friendly.
#### And More!
- Search
- Global application/bookmark search for quick access (⌘ + K).
- Press tab from the global search to enter web search. (optional)
- Configurable hotkey and search engine.
- Theme
- Create your own themes using a custom theme builder.
- Clone existing themes and tweak them.
- Disable any theme you don't want to see.
- Migrate
- Move from [Flame](https://github.com/pawelmalak/flame) to Oak easily with a built-in import utility.
### Uhh... No Logins?
Like many self-hosted applications, Oak is not intended to be hosted publicly. Don't open it up to the internet.
## Usage
### Docker
This application uses SQLite for storage. You must mount your desired database storage path to `/rails/storage`.
#### Example
```
docker run -d -it -p 3000:80 -v /path/on/host:/rails/storage ghcr.io/bert-mccutchen/oak:latest
```
### Unraid
You need to change your storage directory ownership for Oak.
```
chown 1000:1000 /mnt/cache/appdata/oak
```
## Screenshots
### Self-Host
### Bookmark
### Customize
Standard Themes
| Abyss | Acid |
|---|---|
|  |  |
| Aqua | Autumn |
|---|---|
|  |  |
| Black | Bumblebee |
|---|---|
|  |  |
| Business | Caramellatte |
|---|---|
|  |  |
| Cmyk | Coffee |
|---|---|
|  |  |
| Corporate | Cupcake |
|---|---|
|  |  |
| Cyberpunk | Dark |
|---|---|
|  |  |
| Dim | Dracula |
|---|---|
|  |  |
| Emerald | Fantasy |
|---|---|
|  |  |
| Forest | Garden |
|---|---|
|  |  |
| Halloween | Lemonade |
|---|---|
|  |  |
| Light | Lofi |
|---|---|
|  |  |
| Luxury | Night |
|---|---|
|  |  |
| Nord | Pastel |
|---|---|
|  |  |
| Retro | Silk |
|---|---|
|  |  |
| Sunset | Synthwave |
|---|---|
|  |  |
| Valentine | Winter |
|---|---|
|  |  |
| Wireframe |
|---|
|  |
## Mobile Screenshots
| | | | |
|---|---|---|---|
|  |  |  |  |
|  |  |  |  |
Standard Themes (Mobile)
| Abyss | Acid | Aqua | Autumn |
|---|---|---|---|
|  |  |  |  |
| Black | Bumblebee | Business | Caramellatte |
|---|---|---|---|
|  |  |  |  |
| Cmyk | Coffee | Corporate | Cupcake |
|---|---|---|---|
|  |  |  |  |
| Cyberpunk | Dark | Dim | Dracula |
|---|---|---|---|
|  |  |  |  |
| Emerald | Fantasy | Forest | Garden |
|---|---|---|---|
|  |  |  |  |
| Halloween | Lemonade | Light | Lofi |
|---|---|---|---|
|  |  |  |  |
| Luxury | Night | Nord | Pastel |
|---|---|---|---|
|  |  |  |  |
| Retro | Silk | Sunset | Synthwave |
|---|---|---|---|
|  |  |  |  |
| Valentine | Winter | Wireframe |
|---|---|---|
|  |  |  |
## Thanks
Big thanks to [DaisyUI](https://github.com/saadeghi/daisyui) for the component library and themes. Also [Flame](https://github.com/pawelmalak/flame), which has been the inpiration and my homepage for many years.
### Legal Attributions
Icons are modified and colored programatically to match the user's theme. Icons are provided by [selfh.st/icons](https://github.com/selfhst/icons/blob/main/LICENSE), and [Font Awesome Free](https://fontawesome.com/license/free) under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed).