🧰 LobstaKit
Web Dashboard

Web Dashboard

The LobstaKit web dashboard gives you a browser-based GUI for managing your Lobsta installation.


Starting the Dashboard

lobstakit start

By default, the web interface runs on http://0.0.0.0:8080.

For production deployment:

lobstakit start --production --port 8080

Runs with gunicorn (2 workers, 4 threads, 120s timeout).


First-Time Authentication

On your first visit, you'll be prompted to create a password:

  1. Open http://your-host:8080 in a browser.
  2. You'll be redirected to /auth/setup.
  3. Create a password (minimum 4 characters).
  4. You're logged in and redirected to the dashboard.

On subsequent visits, enter your password at /login.

💡

The password hash and salt are stored in ~/.lobsta/auth.json with 0600 permissions.


Dashboard Pages

Main Dashboard (/)

Overview of your system:

  • Docker status (installed, running, version, compose availability)
  • Configuration status (API key set, model, gateway port, Telegram, timezone)
  • Container status (exists, running, image)
  • Health checks (port open, gateway responding)
  • System prerequisites

Setup Wizard (/setup)

Same as the CLI wizard, but through the browser. Walks you through configuration, Docker setup, and starting Lobsta.

Logs Viewer (/logs)

View and stream Lobsta container logs in real-time:

  • Static logs with configurable line count
  • Live streaming via Server-Sent Events

Security Audit (/security)

Run security checks and apply hardening measures from the browser.


Web API Endpoints

All endpoints require authentication (except /login and /auth/setup).

Status & Diagnostics

MethodPathDescription
GET/api/statusComplete system status
GET/api/docker/statusDocker-specific status
GET/api/configCurrent configuration (sensitive values masked)
POST/api/configSave configuration changes
GET/api/diagnosticsFull diagnostics with recommendations

Container Management

MethodPathDescription
GET/api/containersList all Docker containers
GET/api/logs/containerContainer logs (?lines=N)
GET/api/logs/streamStream logs (Server-Sent Events)
GET/api/operation-logsRecent operation logs from the web UI

Actions

MethodPathDescription
POST/api/action/setup-dockerInstall and start Docker
POST/api/action/startStart Lobsta container
POST/api/action/stopStop Lobsta container
POST/api/action/restartRestart Lobsta container
POST/api/action/updateUpdate Lobsta to latest version
POST/api/action/pull-imagePull the latest Docker image
POST/api/action/uninstallUninstall Lobsta (optional remove_config)

Security

MethodPathDescription
GET/api/security/auditRun security audit
POST/api/security/hardenApply security hardening