CLI flags

starklite [flags] <database.sqlite>

Networking

  • --port N — bind a specific port. Default: random in 6000–6999.
  • --bind-localhost — bind 127.0.0.1 only. Use with an SSH tunnel for stricter access.

Authentication

  • --password PASS — set a specific password. Default: random 16-character password.
  • --username NAME — set the login user. Default: admin.

Access mode

  • --readonly — opens the database read-only; the UI hides edit controls; INSERT/UPDATE/DELETE/DDL is rejected.

Lifecycle

  • --expire DURATION — auto-shutdown after the given duration. Example: --expire 30m, --expire 2h.
  • --idle-timeout DURATION — shutdown after no requests for this long. Example: --idle-timeout 15m.

UI

  • --theme dark|light — UI theme. Default: dark.
  • --no-browser — never attempt to open a browser window.

Meta

  • --version — print version and exit.
  • -h, --help — print usage.

Examples

# Quick browse on a server, expires in 30 minutes
starklite /var/www/app/db.sqlite --expire 30m

# Read-only, localhost-only — open via SSH tunnel
starklite /var/www/app/db.sqlite --readonly --bind-localhost

# Pick the port and password explicitly
starklite ./local.db --port 6500 --password 'my-temp-password!'

# Aggressively short-lived support session
starklite ./customer.db --expire 15m --idle-timeout 5m --readonly