{"id":13590034,"url":"https://github.com/aceberg/miniboard","last_synced_at":"2025-10-24T10:52:16.979Z","repository":{"id":174973828,"uuid":"653133754","full_name":"aceberg/miniboard","owner":"aceberg","description":"Lightweight dashboard with tabs, uptime monitoring and notifications","archived":false,"fork":false,"pushed_at":"2023-12-24T11:07:02.000Z","size":730,"stargazers_count":224,"open_issues_count":3,"forks_count":14,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-08T04:18:57.904Z","etag":null,"topics":["dashboard","dashboard-application","docker","golang-application","self-hosted","selfhosted","uptime-monitor"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/aceberg/miniboard","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aceberg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"custom":["https://boosty.to/aceberg/donate","https://aceberg.github.io/MyDocs/sponsor"]}},"created_at":"2023-06-13T13:18:18.000Z","updated_at":"2025-04-02T14:57:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"fae4e9bc-a6bd-4048-9eeb-8a0c73706640","html_url":"https://github.com/aceberg/miniboard","commit_stats":null,"previous_names":["aceberg/miniboard"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/aceberg/miniboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aceberg%2Fminiboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aceberg%2Fminiboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aceberg%2Fminiboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aceberg%2Fminiboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aceberg","download_url":"https://codeload.github.com/aceberg/miniboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aceberg%2Fminiboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280783850,"owners_count":26390277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dashboard","dashboard-application","docker","golang-application","self-hosted","selfhosted","uptime-monitor"],"created_at":"2024-08-01T16:00:38.100Z","updated_at":"2025-10-24T10:52:16.949Z","avatar_url":"https://github.com/aceberg.png","language":"Go","funding_links":["https://boosty.to/aceberg/donate","https://aceberg.github.io/MyDocs/sponsor"],"categories":["Go","置顶","self-hosted","Other"],"sub_categories":["05、运维监控体系","Web Applications"],"readme":"[![Main-Docker](https://github.com/aceberg/miniboard/actions/workflows/main-docker.yml/badge.svg)](https://github.com/aceberg/miniboard/actions/workflows/main-docker.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/aceberg/miniboard)](https://goreportcard.com/report/github.com/aceberg/miniboard)\n[![Maintainability](https://api.codeclimate.com/v1/badges/064657fe6ff0adb0d3ba/maintainability)](https://codeclimate.com/github/aceberg/miniboard/maintainability)\n![Docker Image Size (latest semver)](https://img.shields.io/docker/image-size/aceberg/miniboard)\n\n\u003ch1\u003e\u003ca href=\"https://github.com/aceberg/miniboard\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/aceberg/miniboard/main/assets/logo.png\" width=\"20\" /\u003e\n\u003c/a\u003eminiboard\u003c/h1\u003e\nLightweight dashboard with tabs, uptime monitoring and notifications.\u003cbr\u003e\nCan be configured through GUI or yaml file.     \n\n- [Quick start](https://github.com/aceberg/miniboard#quick-start)\n- [Install binary](docs/INSTALL-BIN.md)\n- [Usage](https://github.com/aceberg/miniboard#usage)\n- [Config](https://github.com/aceberg/miniboard#config)\n- [Options](https://github.com/aceberg/miniboard#options)\n- [Local network only](https://github.com/aceberg/miniboard#local-network-only) \n- [Thanks](https://github.com/aceberg/miniboard#thanks)\n\n![screenshot](https://raw.githubusercontent.com/aceberg/miniboard/main/assets/Screenshot%202023-06-25%20at%2022-55-05%20MiniBoard%20-%20Docker.png)\n\u003cdetails\u003e\n  \u003csummary\u003eMore Themes\u003c/summary\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/aceberg/miniboard/main/assets/MiniBoard%20-%20Themes.png\"\u003e\n\u003c/details\u003e     \n\n## Quick start\n\n```sh\ndocker run --name miniboard \\\n-e \"TZ=$YOURTIMEZONE\" \\\n-v ~/.dockerdata/miniboard:/data/miniboard \\\n-v /var/run/docker.sock:/var/run/docker.sock \\ # Only needed to create panel from Docker containers (On Edit panels page)\n-p 8849:8849 \\\naceberg/miniboard\n```\nOr use [docker-compose.yml](docker-compose.yml)   \nThere is also [binary installation](docs/INSTALL-BIN.md) available.\n\n\n## Usage\nAll 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.   \n\u003cbr\u003e\nAlso, you can start with example [board.yaml](configs/board.yaml) file. All fields are commented there.\n  \n\n## Config\nConfiguration can be done through config file or environment variables\n\n\n| Variable  | Description | Default |\n| --------  | ----------- | ------- |\n| AUTH | Enable Session-Cookie authentication | false |\n| AUTH_EXPIRE | Session expiration time. A number and suffix: **m, h, d** or **M**. | 7d |\n| AUTH_USER | Username | \"\" |\n| AUTH_PASSWORD | Encrypted password (bcrypt). [How to encrypt password with bcrypt?](docs/BCRYPT.md) | \"\" |\n| HOST | Listen address | 0.0.0.0 |\n| PORT   | Port for web GUI | 8849 |\n| THEME | Any theme name from https://bootswatch.com in lowcase | flatly |\n| COLOR | Background color: light or dark | dark |\n| COLORON | Online host color | #89ff89 |\n| COLOROFF | Offline host color | #ff3232 |\n| BTNWIDTH | Adjust buttons to theme | 180px |\n| WEBREFRESH | Refresh interval for Tabs and Uptime pages (seconds) | 60 |\n| DBTRIMDAYS | Remove old records from DB after | 30 |\n| TZ | Time zone (for uptime monitor) | \"\" |\n\n## Options\n| Key  | Description | Default | \n| --------  | ----------- | ------- | \n| -b | Path to board file | /data/miniboard/board.yaml |\n| -c | Path to config file | /data/miniboard/config.yaml |\n| -d | Path to SQLite DB file | /data/miniboard/uptime.db |\n| -n | Path to node modules (see below) | \"\" |\n\n## Local network only\nBy 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](https://github.com/aceberg/my-dockerfiles/tree/main/node-bootstrap) with all necessary modules and fonts.    \nIf 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.\n```sh\ndocker run --name node-bootstrap       \\\n    -v ~/.dockerdata/icons:/app/icons  \\ # For local icons\n    -p 8850:8850                       \\\n    aceberg/node-bootstrap\n```\n```sh\ndocker run --name miniboard \\\n    -v ~/.dockerdata/miniboard:/data/miniboard \\\n    -p 8849:8849 \\\n    aceberg/miniboard -n \"http://$YOUR_IP:8850\"\n```\nOr use [docker-compose](docker-compose-local.yml)\n\n## Thanks\n- All go packages listed in [dependencies](https://github.com/aceberg/miniboard/network/dependencies)\n- Favicon and logo: [Skateboard icons created by Freepik - Flaticon](https://www.flaticon.com/free-icons/skateboard)\n- [Bootstrap](https://getbootstrap.com/)\n- Themes: [Free themes for Bootstrap](https://bootswatch.com)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faceberg%2Fminiboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faceberg%2Fminiboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faceberg%2Fminiboard/lists"}