bitdruid/pinboard repository overview

⁠about

A centered grid of round buttons linking to your services plus key/value notes below — a fast, shareable dashboard for internal services.

• round entry buttons with name, url, optional description (opened via eye icon) and optional image (file upload or url, stored as base64)
• edit mode: add, edit, delete and drag-reorder entries and notes
• key/value notes table below the buttons
• config export/import as json (edit mode)
• accent color switcher (persisted per browser, incl. favicon)
• application log in a dedicated tab (with level filtering)
• optional single-user login

⁠run

⁠docker

⁠get image

docker pull bitdruid/pinboard:latest

docker buildx build -t bitdruid/pinboard:latest . --load

⁠compose

docker-compose up -d

⁠script

bash start.sh [options]

Options:

• -b, --base-path PATH - Public base path when hosting under a subdirectory (example: /subdir1/app)
• -u, --login-user USER - Enable login with this username
• -w, --login-pw PW - Password for the login user
• -t, --login-timeout MIN - Session idle timeout in minutes (default: 60)
• --help - Show help message

⁠cli

• Python >= 3.13

pipx install .
# or: uv tool install .
pinboard

Options:

• --host HOST - Interface to bind the server to (default: 0.0.0.0)
• --port PORT - Port for the server (default: 5000)
• --base-path PATH - Public base path when hosting under a subdirectory (example: /subdir1/app)
• --login-user USER - Enable login with this username (requires --login-pw)
• --login-pw PW - Password for the login user (requires --login-user)
• --login-timeout MIN - Session idle timeout in minutes (default: 60)
• --reload - Auto-reload on code changes (development only)

⁠envs

⁠volumes