CLI Reference

Complete command-line interface for managing NANO runtime and applications

Overview

The NANO CLI provides commands for running the server, managing applications, and creating sliver snapshots.

Usage
nano-rs [OPTIONS] <COMMAND>

Commands:
  run     Run the NANO server
  app     Application management
  sliver  Sliver snapshot management
  help    Print this message or help for given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

nano-rs run

Run the NANO server with the specified configuration.

Options
-c, --config <FILE>    Configuration file path [default: nano.json]
-p, --port <PORT>      Override port from config
-w, --workers <N>      Number of worker threads
-d, --debug            Enable debug logging
-h, --help             Print help
Example
# Run with default config
nano-rs run

# Run with custom config and port
nano-rs run --config production.json --port 8080

# Run with debug logging
nano-rs run --debug

nano-rs app

Manage deployed applications.

Subcommands
app deploy    Deploy a new application
app list      List all applications
app info      Show application details
app remove    Remove an application
app restart   Restart an application
Example: Deploy an app
# Deploy from a directory
nano-rs app deploy ./my-app --name my-app --domain app.example.com

# Deploy from a sliver
nano-rs app deploy --sliver my-app-v1.0 --name my-app

nano-rs sliver

Manage sliver snapshots for fast cold starts.

Subcommands
sliver create    Create a sliver snapshot
sliver list      List all slivers
sliver info      Show sliver details
sliver delete    Delete a sliver
Example: Create a sliver
# Create from a running app
nano-rs sliver create localhost --name my-app --tag v1.0

# Create from a directory
nano-rs sliver create ./my-app --name my-app --tag v1.0

# List all slivers
nano-rs sliver list --verbose
← Slivers Runtime →