rdc vs renet

Rediacc ships two binaries. Two jobs, two places. Here is which is which.

	rdc	renet
Runs on	Your workstation	The remote server
Connects via	SSH	Runs locally with root
Used by	Everyone	Advanced debugging only
Install	You install it	rdc provisions it automatically

For day-to-day work, use rdc. You rarely need renet directly.

How They Work Together

On your workstation you run rdc. It opens an SSH connection to your server and runs the matching renet command there for you. One command, one place to run it:

1. Reads your local config (~/.config/rediacc/rediacc.json)
2. Connects to the server over SSH
3. Updates the renet binary if needed
4. Runs the matching renet operation on the server
5. Returns the result to your terminal

Use rdc for Normal Work

All common tasks go through rdc on your workstation:

# Set up a new server
rdc config machine setup --name server-1

# Create and start a repository
rdc repo create --name my-app -m server-1 --size 10G
rdc repo up --name my-app -m server-1

# Stop a repository
rdc repo down --name my-app -m server-1

# Check machine health
rdc machine health --name server-1

See the Quick Start for a full walkthrough.

Use renet for Server-Side Debugging

You only need renet directly when you SSH into a server for:

• Emergency debugging when rdc cannot connect
• Checking system internals not available through rdc
• Low-level recovery operations

All renet commands need root privileges (sudo). rdc does not wrap every renet subcommand; for anything not covered, SSH in and call renet directly. See Server Reference for the full list of renet commands.

Experimental: rdc ops (Local VMs)

rdc ops wraps renet ops for managing local VM clusters on your workstation:

rdc ops setup              # Install prerequisites (KVM or QEMU)
rdc ops up --basic         # Start a minimal cluster
rdc ops status             # Check VM status
rdc ops ssh --vm-id 1  # SSH into bridge VM
rdc ops ssh --vm-id 1 -c hostname  # Run a command on bridge VM
rdc ops down               # Destroy cluster

Requires the local adapter. Not available with the cloud adapter.

These commands run renet locally (not over SSH). See Experimental VMs for full documentation.

Rediaccfile Note

You’ll see renet compose -- ... inside a Rediaccfile. Don’t worry. Rediaccfile functions run on the server, where renet is already installed.

From your workstation, start and stop workloads with rdc repo up and rdc repo down.