Getting started

Titanium Web Proxy helps you do three things:

1. Inspect HTTP/HTTPS traffic in a desktop app (Inspector)
2. Run a reverse proxy in front of your apps (CLI)
3. Embed the same engine in a .NET application (Library)

Optional Plus adds a dashboard and ops features on top of the CLI. Everything runs on Windows, Linux, and macOS.

Highlights

Native HTTPS Inspector with AutoResponder, Map Local/Remote, breakpoints, Composer, and HAR; when a server blocks the proxy we detect it and tunnel automatically; HTTP/2 / HTTP/3 with WebSocket, gRPC, and GraphQL in the grid; the same engine as a reverse/edge CLI; embed via NuGet. Full catalog: Features.

Choose a path

I want to…	Start here
Debug browser or app traffic	Download Inspector → Inspector guide
Put a proxy in front of my site or API	Download CLI → create twp.yaml below → CLI
Add dashboard / metrics / auth helpers	Plus after installing the CLI
Use Titanium inside a .NET app	Library + NuGet

Reverse proxy in a minute (CLI)

1. Download the CLI for your OS and extract it (or Homebrew on macOS — see Install).
2. Create twp.yaml that forwards to your backend (example: local port 8080):

schemaVersion: "7.1"
listeners:
  - host: "127.0.0.1"
    port: 8000
    # false = do not decrypt HTTPS (plain reverse proxy)
    decryptSsl: false
    forwardHost: "127.0.0.1"
    forwardPort: 8080

3. Validate and run:

titanium test -c twp.yaml
titanium run -c twp.yaml

titanium run stays in the foreground (Ctrl+C to stop). To start at boot: titanium service install -c twp.yaml — see CLI — service. More YAML: Configuration. When a request fails, the Error log names the limit and the key: Limits and troubleshooting.

Inspect traffic (Inspector)

1. Download and install Inspector.
2. Launch it — capturing and system proxy are on by default on the local machine.
3. Turn on Decrypt HTTPS when you need to see inside HTTPS (installs a local root certificate — only on machines you control).

Details: Inspector.

Embed in .NET (Library)

dotnet add package Titanium.Web.Proxy
# Newer than stable:
dotnet add package Titanium.Web.Proxy --prerelease

Minimal sample and trust notes: Library. Full API: ProxyServer.

Platforms at a glance

Product	Platforms
CLI / Plus	Windows, Linux, macOS (self-contained — no .NET SDK to run)
Inspector	Windows, macOS, Linux
Library	.NET 10 (NuGet)

Next

• Features
• Install
• Editions & licenses
• Performance