Documentation
📘 Commands

RF Swift Command Reference

RF Swift Command Reference

Complete reference for all RF Swift commands. Each command has its own dedicated page with syntax, options, and examples.

Quick Help: Use rfswift [command] --help for instant command help.

🔌 Global Flags

Disconnected Mode

All RF Swift commands support the -q or --disconnect flag to disable update checks when working offline or in air-gapped environments:

# Work without querying for updates
rfswift -q run -i sdr_full -n work
rfswift --disconnect last
rfswift -q images local

# Useful for:
# - Offline/air-gapped systems
# - Avoiding network delays
# - Scripting/automation
# - Systems behind firewalls

When disconnected mode is enabled, RF Swift skips checking for new versions and runs immediately without any network queries. All functionality remains available - only the update notification system is disabled.

📋 Command Categories

🐳 Container Management

run
Create and start a new container
 exec
Execute commands in a running container
 stop
Stop a running container
 remove
Remove a container
 rename
Rename a container
 commit
Save container as new image

🖼️ Image Management

images
Manage RF Swift images (pull, list, search)
 build
Build image from YAML recipe
 delete
Delete an image
 retag
Rename an image tag
 download
Download and save image to tar.gz
 import
Import containers or images
 export
Export containers or images

⚙️ Dynamic Configuration

bindings
Manage device and volume bindings
 capabilities
Manage Linux capabilities
 cgroups
Manage cgroup device rules
 ports
Manage container ports

📹 Session Recording

log
Record and replay terminal sessions

🔧 System Operations

host
Host system configuration
 update
Update RF Swift binary
 completion
Generate shell completion scripts
 install
Install helper scripts

🛠️ Utilities

last
Show recently used containers
 cleanup
Clean up old containers and images
 upgrade
Upgrade container to new image

🚀 Quick Reference

Command Purpose
rfswift run -i IMAGE -n NAME Create new container
rfswift exec -c CONTAINER Enter container
rfswift last List recent containers
rfswift bindings add -c CONTAINER -d -t DEVICE Add device
rfswift capabilities add -c CONTAINER -a CAP Add capability
rfswift ports bind -c CONTAINER -p PORT Bind port
rfswift images pull -i IMAGE Download image
rfswift build -r RECIPE.yaml Build from recipe
rfswift log replay -i FILE.cast Replay session
rfswift update Update RF Swift

🆘 Getting Help 

rfswift --help              # All commands
rfswift run --help          # Specific command
rfswift bindings add --help # Subcommand
💡
New to RF Swift? Start with the Quick Start Guide before diving into command details.
Last updated on
🛠️ Container Scriptsrun