Command Reference

The installer puts one command on your server, /usr/local/bin/row-template. It is a thin launcher for the management library in the install directory — /etc/3x-ui/sub_templates/row-template on 3X-UI, /etc/row-template on PasarGuard and Rebecca. The commands are the same on every panel.

row-template <command> [options]

Run it with no arguments in a terminal to open the interactive manager. Without a terminal — in a script, cron, CI, or curl | bash — it prints the help instead, so it never waits for input.

Commands

Command	What it does	Root
`row-template config`	Change the service name, support URL or logo, then regenerate the page. Branding →	Yes
`row-template update`	Download, verify and activate the latest stable release. Updating →	Yes
`row-template rollback`	Restore a previous version from a backup. Options: `--auto`, `--to <backup>`. Rollback →	Yes
`row-template verify`	Check the installation, the panel wiring and the live page. Verify →	Recommended
`row-template version`	Show the installed version and the panel it serves; on 3X-UI, also the minimum supported and the detected 3X-UI version. Aliases: `-v`, `--version`.	No
`row-template uninstall`	Remove Row-Template and return the panel to the page it had before. Uninstall →	Yes
`row-template menu`	Open the interactive manager explicitly. Alias: `manager`.	Yes
`row-template help`	Show usage. Aliases: `-h`, `--help`.	No

Commands that change the system refuse to run without root:

  FAIL this operation must run as root (e.g. sudo row-template ...)

verify does not insist on root, but as another user it cannot read config.env or the panel’s settings, so it reports less. Run as root, it also puts the template store right before checking — see Verify.

version

row-template version

Row-Template 1.4.0
Panel: 3X-UI
Supported 3x-ui minimum: 3.6.0
Detected 3x-ui: 3.8.5

Row-Template 1.4.0
Panel: PasarGuard

Row-Template 1.4.0
Panel: Rebecca

unknown means the value could not be read. Include this output in bug reports.

rollback options

Form	Restores
`row-template rollback`	The newest valid backup.
`row-template rollback --auto`	The same, stated explicitly.
`row-template rollback --to <backup>`	A specific backup: its full path, or just its folder name under `backups/`.

Output

Every command prints short status lines:

  ok   Canonical artifact integrity verified.
  warn PasarGuard does not select the Row-Template page; activate it from the manager.
  FAIL verification FAILED (1 hard issue(s), 1 warning(s)).

ok lines go to standard output; warn and FAIL lines go to standard error. Messages from a panel adapter start with the panel, such as panel pasarguard: or panel rebecca:. Colour is used only on a terminal, and never when NO_COLOR is set. Every warn and FAIL message is explained in the error reference.

Exit status

Status	Meaning
`0`	Success. For `verify`: no hard failures (warnings allowed).
`1`	The command failed, or `verify` found a hard failure.
`2`	Unknown command — the help is printed after the error.

Commands that change the system work as transactions: when one fails part-way, it restores the previous state before it exits and says so. If it ever cannot, it tells you to run row-template rollback.

When the command itself is broken

If the management library is missing, the launcher cannot load anything and prints, for example on 3X-UI:

row-template: management library not found at /etc/3x-ui/sub_templates/row-template/lib/row-template.sh
row-template: the install may be damaged; re-run the installer.

Re-running the installer repairs the installation in place and keeps your configuration.