Skip to main content

Diagnostics & System Commands

The CLI provides comprehensive diagnostics, performance counters, health probes, and media optimization commands.

1. liorans3 doctor​

Performs an end-to-end diagnostic audit of the Node runtime, local configuration files, credential validity, endpoint reachability, and server health.

liorans3 doctor

Example Output​

=== Lioran S3 CLI Doctor [v0.1.0-prealpha.2] ===

[OK]           Runtime Environment
               Node.js v22.5.0 (win32 x64)

[OK]           Configuration Store
               Configuration loaded successfully (2 profiles)

[OK]           Authentication Credentials
               Authentication configured (User (admin))

[OK]           Target Endpoint
               Resolved endpoint: http://127.0.0.1:27118

[OK]           Server Connectivity & Health
               Connected successfully (Server: Lioran Bastion v0.1.0, Status: ok)

[OK]           Server Diagnostic Information
               Server details verified (Listen Addr: 127.0.0.1:27118)

All diagnostic checks passed. Lioran S3 CLI is ready for use.

2. liorans3 ping​

Measures round-trip HTTP latency to the configured server:

liorans3 ping

Output:

PONG: 4ms (status: ok, version: 0.1.0, endpoint: http://127.0.0.1:27118)

3. liorans3 whoami​

Displays the active profile, resolved endpoint, authentication mode, and identity:

liorans3 whoami

Output:

Profile:     default
Endpoint:    http://127.0.0.1:27118
Auth Type:   basic
Identity:    admin
Timeout:     30000 ms

4. liorans3 system Commands​

Server Health (system health)​

liorans3 system health

Output:

Server Health: OK
  Name:    Lioran Bastion
  Version: 0.1.0

System Info (system info)​

liorans3 system info

Output:

System Information:
  Name:        Lioran Bastion
  Version:     0.1.0
  Listen Addr: 127.0.0.1:27118

Performance & Latency Breakdown (system performance, alias: perf)​

Retrieves real-time PUT latency, stream duration, write duration, and throughput metrics:

liorans3 system performance

Output:

System PUT Performance Breakdown:
  Total PUTs:      12,450
  Successful PUTs: 12,448
  Failed PUTs:     2
  Total Bytes:     42.50 GiB (45634027520 B)
  Throughput:      312.45 MiB/s
  Avg Stream Time: 3.20 ms
  Avg Write Time:  2.10 ms
  Avg Flush Time:  1.40 ms

Prometheus Metrics (system metrics)​

Streams raw Prometheus exposition format text:

liorans3 system metrics

5. liorans3 image optimize​

Transforms, resizes, and converts images stored on the server:

liorans3 image optimize assets hero.jpg \
  --width 1920 \
  --height 1080 \
  --fit fit \
  --format webp \
  --quality 80 \
  --target-key hero-1080p.webp

6. liorans3 video Commands (Experimental)​

The video command group manages video ingestion, HLS transcoding manifests, and shareable links:

  • liorans3 video list: List all video assets.
  • liorans3 video get <videoId>: Retrieve HLS stream URLs, master playlist, and poster frame.
  • liorans3 video upload <bucket> <file>: Upload video file with automated chunking.
  • liorans3 video status <videoId>: Check FFmpeg transcoding progress.
  • liorans3 video share create <videoId>: Create a public shareable playback URL.