MCPcopy Index your code
hub / github.com/aceberg/miniboard

github.com/aceberg/miniboard @1.2.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release 1.2.2 ↗ · + Follow
71 symbols 249 edges 42 files 35 documented · 49%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Main-Docker Go Report Card Maintainability Docker Image Size (latest semver)

miniboard

Lightweight dashboard with tabs, uptime monitoring and notifications.

Can be configured through GUI or yaml file.

screenshot

More Themes

Quick start

docker run --name miniboard \
-e "TZ=$YOURTIMEZONE" \
-v ~/.dockerdata/miniboard:/data/miniboard \
-v /var/run/docker.sock:/var/run/docker.sock \ # Only needed to create panel from Docker containers (On Edit panels page)
-p 8849:8849 \
aceberg/miniboard

Or use docker-compose.yml
There is also binary installation available.

Usage

All configuration can be done both with GUI or config file. To start with GUI first create new panel, then create new tab with this panel. Then you can add as many hosts (to panels), panels and tabs as you want.

Also, you can start with example board.yaml file. All fields are commented there.

Config

Configuration can be done through config file or environment variables

Variable Description Default
AUTH Enable Session-Cookie authentication false
AUTH_EXPIRE Session expiration time. A number and suffix: m, h, d or M. 7d
AUTH_USER Username ""
AUTH_PASSWORD Encrypted password (bcrypt). How to encrypt password with bcrypt? ""
HOST Listen address 0.0.0.0
PORT Port for web GUI 8849
THEME Any theme name from https://bootswatch.com in lowcase flatly
COLOR Background color: light or dark dark
COLORON Online host color #89ff89
COLOROFF Offline host color #ff3232
BTNWIDTH Adjust buttons to theme 180px
WEBREFRESH Refresh interval for Tabs and Uptime pages (seconds) 60
DBTRIMDAYS Remove old records from DB after 30
TZ Time zone (for uptime monitor) ""

Options

Key Description Default
-b Path to board file /data/miniboard/board.yaml
-c Path to config file /data/miniboard/config.yaml
-d Path to SQLite DB file /data/miniboard/uptime.db
-n Path to node modules (see below) ""

Local network only

By default, this app pulls themes, icons and fonts from the internet. But, in some cases, it may be useful to have an independent from global network setup. I created a separate image with all necessary modules and fonts.
If you want to use local icons, download them and mount icon folder (~/.dockerdata/icons in this example) to /app/icons. Then you can open it in browser and copy each icon link to miniboard.

docker run --name node-bootstrap       \
    -v ~/.dockerdata/icons:/app/icons  \ # For local icons
    -p 8850:8850                       \
    aceberg/node-bootstrap

docker run --name miniboard \
    -v ~/.dockerdata/miniboard:/data/miniboard \
    -p 8849:8849 \
    aceberg/miniboard -n "http://$YOUR_IP:8850"

Or use docker-compose

Thanks

Core symbols most depended-on inside this repo

IfError
called by 20
internal/check/error.go
Auth
called by 12
internal/auth/auth.go
execTemplate
called by 11
internal/web/exec-tpl.go
Write
called by 7
internal/yaml/readwrite.go
exec
called by 4
internal/db/sqlite.go
IsLoggedIn
called by 3
internal/auth/session.go
getTokenFromCookie
called by 3
internal/auth/cookie.go
assignAllIDs
called by 3
internal/web/assign-IDs.go

Shape

Function 61
Struct 10

Languages

Go100%

Modules by API surface

internal/models/models.go9 symbols
internal/web/assign-IDs.go4 symbols
internal/db/edit.go4 symbols
internal/db/sqlite.go3 symbols
internal/auth/session.go3 symbols
internal/yaml/readwrite.go2 symbols
internal/web/webgui.go2 symbols
internal/web/scan.go2 symbols
internal/web/scan-uptime.go2 symbols
internal/web/index.go2 symbols
internal/web/db-trim.go2 symbols
internal/web/config.go2 symbols

For agents

$ claude mcp add miniboard \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact