CLI Reference

Commands

Deploy proxy server to a VPS.

meridian deploy [IP] [flags]

Flag	Default	Description
`--sni HOST`	www.microsoft.com	Site that Reality impersonates
`--domain DOMAIN`	(none)	Enable domain mode with CDN fallback
`--email EMAIL`	(none)	Email for TLS certificates
`--xhttp / --no-xhttp`	enabled	XHTTP transport
`--name NAME`	default	Name for the first client
`--user USER`	root	SSH user
`--yes`		Skip confirmation prompts

Manage client access keys.

meridian client add NAME [--server NAME]
meridian client list [--server NAME]
meridian client remove NAME [--server NAME]

Manage known servers.

meridian server add [IP]
meridian server list
meridian server remove NAME

Pre-flight server validation. Tests SNI, ports, DNS, OS, disk, ASN without installing anything.

meridian preflight [IP] [--ai] [--server NAME]

Find optimal SNI targets on the server’s network using RealiTLScanner.

meridian scan [IP] [--server NAME]

Test proxy reachability from the client device. No SSH needed.

meridian test [IP] [--server NAME]

Collect system diagnostics for debugging. Alias: meridian rage.

meridian doctor [IP] [--ai] [--server NAME]

Remove proxy from server.

meridian teardown [IP] [--server NAME] [--yes]

Update CLI to latest version.

meridian update

Show CLI version.

meridian --version
meridian -v

Flag	Description
`--server NAME`	Target a specific named server

Commands that need a server follow this priority: