ShieldGate Docs

First proxy

Create a host

Register the public hostname your Proxy will accept.

Goal

Create a Proxy host that represents the public name clients use.

Prerequisites

  • Admin console access with proxy.hosts.write (or platform admin).

Steps (console)

  1. Open Topology → Hosts.
  2. Choose Create (or equivalent).
  3. Set the hostname (for example app.localhost or your real FQDN).
  4. Enable the host if there is an enabled toggle.
  5. Save.

Steps (API)

POST /api/v1/hosts

Use a JWT or API key with proxy.hosts.write. Successful topology writes usually auto-publish unless you pass skipPublish: true.

Verify

  • The host appears in the Hosts list.
  • Hostname matches exactly what clients (or your test curl -H "Host: …") will send.

Tips

  • Certificate bindings later must match enabled hostnames for ACME.
  • Local testing often uses *.localhost or /etc/hosts entries pointing at the Proxy.

Next

Create cluster and destinations