CLI Command Reference

LobstaKit provides 11 CLI commands for managing your self-hosted Lobsta installation.

`lobstakit install`

Run the full installation wizard: prerequisites → Docker → configuration → image pull → start.

lobstakit install

See Installation for the complete step-by-step walkthrough.

`lobstakit start`

Start the LobstaKit web interface (Flask server).

lobstakit start                     # Default: 0.0.0.0:8080
lobstakit start -p 9090             # Custom port
lobstakit start --production        # Gunicorn mode
lobstakit start -h 127.0.0.1       # Localhost only
lobstakit start --debug             # Debug mode

Flag	Default	Description
`--host`, `-h`	`0.0.0.0`	Host to bind to
`--port`, `-p`	`8080`	Port to run on
`--debug`, `-d`	`false`	Enable Flask debug mode
`--production`	`false`	Use gunicorn (requires `lobstakit[prod]`)

`lobstakit stop`

Stop the Lobsta container.

lobstakit stop

`lobstakit restart`

Restart the Lobsta container (stop then start).

lobstakit restart

`lobstakit status`

Quick status check from the command line.

lobstakit status
# 🛠️  LobstaKit Status
# ========================================
# ✓ Docker: Running
# ✓ Config: Ready (port 3000)
# ✓ Lobsta: Up 2 hours
# ✓ Health: Gateway responding

`lobstakit config`

Run the interactive configuration wizard (without the full install flow).

lobstakit config

Walks through: API Key → Model → Gateway Port → Telegram → System Settings.

`lobstakit version`

Show the LobstaKit version.

lobstakit version
# LobstaKit v0.1.0

`lobstakit logs`

View Lobsta container logs.

lobstakit logs                    # Last 50 lines
lobstakit logs -n 200             # Last 200 lines
lobstakit logs -f                 # Follow (stream) logs
lobstakit logs -f -n 100          # Follow starting from last 100 lines

`lobstakit update`

Update Lobsta to the latest version. Stops the container, pulls the latest image, and restarts.

lobstakit update
# Stopping current instance...
# Pulling latest image...
# Starting updated instance...
# ✓ Lobsta updated!

`lobstakit doctor`

Run comprehensive health diagnostics with recommendations.

lobstakit doctor
# 🩺 Lobsta Doctor
# Running comprehensive health check...
#
# ┌─────────────────────────────────────┐
# │ Docker Installed    ✓ Docker 24.0   │
# │ Docker Running      ✓ Daemon active │
# │ Config File         ✓ ~/.lobsta/... │
# │ Container Status    ✓ Up 2 hours    │
# │ Gateway Port        ✓ Port 3000 open│
# │ Health Check        ✓ Responding    │
# └─────────────────────────────────────┘
#
# ✓ All checks passed!

`lobstakit harden`

Run a security audit and optionally apply hardening measures.

lobstakit harden
# 🔒 LobstaKit Security Hardening
#
# Running security audit...
#   ✅ Firewall configured
#   ❌ SSH root login enabled
#   ✅ Docker socket permissions
#   ...
#
# Score: 5/7 checks passed
#
# Apply security hardening? [y/N]:

Installation Web Dashboard