Skip to content

CLI (titanium / twp)

Standalone reverse / edge proxy for any backend stack. MIT licensed. Self-contained binaries for Windows, Linux, and macOS — Download.

Commands

text
titanium run -c <config> [-v|--verbose]
titanium test -c <config>
titanium version [--check] [--plus] [--channel beta]
titanium update [--plus] [--channel beta]

twp is an alias for the same binary.

CommandPurpose
runStart the proxy from YAML/JSON (or other dialects)
testValidate config without serving traffic
versionPrint local version; --check compares to the update feed
updateDownload a newer CLI zip; --plus updates the Plus sidecar DLL

Channels: stable (default) or beta via --channel or TITANIUM_UPDATE_CHANNEL.

Minimal ForwardHost reverse

yaml
schemaVersion: "7.0"
listeners:
  - host: "127.0.0.1"
    port: 8000
    decryptSsl: false
    forwardHost: "127.0.0.1"
    forwardPort: 8080
shell
titanium test -c twp.yaml
titanium run -c twp.yaml

Routes and clusters

For path-based routing and load balancing, see Configuration.

Plus sidecar

shell
titanium update --plus

Enable in config (plus.enabled: true + control-plane shared secret). Details: Plus.

Config dialects

ExtensionDialect
.yaml / .yml / .jsonNative twp schema 7.0
.twpCompact site-file (host / => http://origin)
.confnginx-ish (listen, server_name, location, proxy_pass)

See also

Core & CLI: MIT · Plus & Inspector: PolyForm Noncommercial