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 bundles.

Usage
nano-rs [OPTIONS] <COMMAND>

Commands:
  run     Run the NANO server
  app     Application management
  sliver  Sliver bundle management (create, list, delete)
  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

Create, list, and delete portable app bundles.

Subcommands
sliver create --from-dir <dir>    Bundle a directory into a sliver
sliver list                       List all slivers
sliver delete <name>              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 →