The Perimeter81 Developer Hub

Welcome to the Perimeter81 developer hub. You'll find comprehensive guides and documentation to help you start working with Perimeter81 as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Heroku Enterprise

Heroku Private Spaces can configure a connection to Perimeter 81 using IPSec. This lets you connect to hosts on your private networks and vice versa. Connections are established over the public Internet, but all traffic is encrypted using IPSec.

Setting up the VPN Connection

After you obtain your private Perimeter 81 gateway, set up a VPN gateway for the Private Space with the following command:

heroku spaces:vpn:connect \
    --name perimeter81 \
    --cidrs '' \
    --space SPACE

Setting up the gateway takes a few minutes. Use the wait command to wait for the gateway to be ready:

heroku spaces:vpn:wait --space SPACE perimeter81

When the gateway is ready, get the configuration with:

heroku spaces:vpn:info --space SPACE perimeter81

This returns a table containing all the details you need to configure Perimeter 81. Here is an example response:

heroku spaces:vpn:info --space SPACE perimeter81
VPN Tunnel  Customer Gateway  VPN Gateway    Pre-shared Key  Routable Subnets  IKE Version
──────────  ────────────────  ─────────────  ──────────────  ────────────────  ───────────
Tunnel 1 abcdef12345       1
Tunnel 2  123456abcdef       1

Then please contact us at, to coordinate and share the configuration above securely.

Heroku Enterprise

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.