Sign inSign up

apicomplexa/dashboard

By apicomplexa

•Updated over 2 years ago

Simple dashbord for your homeserver

Image
Web servers
0

527

apicomplexa/dashboard repository overview

⁠Set-up

  1. Install docker⁠
  2. Somewhere on your server create services.json with your server settings
  • Group
    • title text in header of services group
    • icon id of licide icon⁠ for group header
    • services list of services in this group
  • Service
    • title text in card
    • url path to service (like https://example.com)
    • logo_path path to service icon (find it using DevTools in browser or RBM -> Copy link to image). If you want use llcide icon leave this field empty ("")
    • icon (optional) id of licide icon⁠ for service card. Using if logo_path is empty, incorrect or unavailable

Structure of services.json

[
    {
        "title": "Group 1 title",
        "icon": "lucide-icon-for-groupe",
        "services": [
            {
                "title": "Service 1 title",
                "url": "service-1.com",
                "logo_path": "service-1.com/icon.png" // or "" for using icon
                "icon": "lucide-icon-for-service" // optional
            },
            {
                "title": "Service 2 title",
                ...
            }
        ]
    },
    {
        "title": "Group 2 title",
        ...
    }
]
  1. Start docker container
export PORT = 80
export PATH_TO_SERVICES_JSON = "abs/path/to/services.json"
docker pull apicomplexa/dashboard
docker run -d -v $PATH_TO_SERVICES_JSON:/app/services.json -p $PORT:80 --name="dashboard" apicomplexa/dashboard
  1. Dashboard available in http://localhost:$PORT (80 by default)
  2. Changing in services.json don't require restarting of container, just page reload (and cleaning cache sometimes)
  3. You can use reverse proxy to get SSl certivicate and use HTTPS

⁠Credits

⁠Developing

  1. Clone this repo
  2. Create services.json in /public/ directory
  3. npm start

In that moment in dev mode service running requests are always positive. Couse now in dev mode simple react-scripts start is used for hot-reload and other tips, but not custom nginx server for processing requests to services. I'm going to change that someday.

Tag summary

Content type

Image

Digest

sha256:0a78ac244…

Size

20.4 MB

Last updated

over 2 years ago

docker pull apicomplexa/dashboard