---
id: "ibm-vpn-gateway"
type: "component"
kind: "vpn-gateway"
provider: "ibm"
category: "edge"
docs: "https://cloud.ibm.com/docs/vpc?topic=vpc-using-vpn"
url: "https://localhost:3000/catalogue/components/ibm-vpn-gateway"
---

# IBM Cloud VPN for VPC

IPsec site-to-site tunnel from a VPC to an on-premises network or another VPC, route-based or policy-based.

| | |
|---|---|
| Provider | [ibm](https://localhost:3000/catalogue?provider=ibm) |
| Kind | [VPN gateway](https://localhost:3000/catalogue/kinds/vpn-gateway) |
| Category | Edge |
| Official docs | [https://cloud.ibm.com/docs/vpc?topic=vpc-using-vpn](https://cloud.ibm.com/docs/vpc?topic=vpc-using-vpn) |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `activeActive` | boolean | — | no | false | inherited |
| `bgp` | boolean | — | no | false | inherited |
| `haMode` | enum | `active-backup`, `active-active`, `active-standby` | no | — | inherited |
| `managed` | boolean | — | no | false | **true** |
| `mode` | enum | `route-based`, `policy-based` | no | — | inherited |
| `peerType` | enum | `site-to-site`, `point-to-site`, `cloud-to-cloud` | no | — | **"site-to-site"** |
| `throughputMbps` | integer | — | no | — | inherited |
| `tunnelType` | enum | `ipsec`, `ssl`, `wireguard` | no | — | **"ipsec"** |

Bold values are the ones this component pins.

## Rules that apply · 0

No rule selects this kind or its category.

## Other products of the same kind · 18

- [VPN Gateway](https://localhost:3000/catalogue/components/alibaba-vpn-gateway.md) `alibaba-vpn-gateway` — alibabacloud
- [AWS Client VPN](https://localhost:3000/catalogue/components/aws-client-vpn.md) `aws-client-vpn` — aws
- [AWS Site-to-Site VPN](https://localhost:3000/catalogue/components/aws-site-to-site-vpn.md) `aws-site-to-site-vpn` — aws
- [Azure VPN Gateway](https://localhost:3000/catalogue/components/azure-vpn-gateway.md) `azure-vpn-gateway` — azure
- [NetBird](https://localhost:3000/catalogue/components/netbird.md) `netbird` — default
- [OpenVPN](https://localhost:3000/catalogue/components/openvpn.md) `openvpn` — default
- [strongSwan](https://localhost:3000/catalogue/components/strongswan.md) `strongswan` — default
- [Submariner](https://localhost:3000/catalogue/components/submariner.md) `submariner` — default
- [Tailscale](https://localhost:3000/catalogue/components/tailscale.md) `tailscale` — default
- [Generic VPN gateway](https://localhost:3000/catalogue/components/vpn-gateway.md) `vpn-gateway` — default
- [WireGuard](https://localhost:3000/catalogue/components/wireguard.md) `wireguard` — default
- [ZeroTier](https://localhost:3000/catalogue/components/zerotier.md) `zerotier` — default
- [Cloud VPN](https://localhost:3000/catalogue/components/google-cloud-vpn.md) `google-cloud-vpn` — gcp
- [Client VPN for VPC](https://localhost:3000/catalogue/components/ibm-vpn-server.md) `ibm-vpn-server` — ibm
- [Site-to-Site VPN](https://localhost:3000/catalogue/components/oci-site-to-site-vpn.md) `oci-site-to-site-vpn` — oci
- [Neutron VPNaaS](https://localhost:3000/catalogue/components/openstack-neutron-vpnaas.md) `openstack-neutron-vpnaas` — openstack
- [Client Gateway](https://localhost:3000/catalogue/components/outscale-client-gateway.md) `outscale-client-gateway` — outscale
- [Virtual Gateway](https://localhost:3000/catalogue/components/outscale-virtual-gateway.md) `outscale-virtual-gateway` — outscale

## Use it in a design

```yaml
nodes:
  - { id: "ibm-vpn-gateway", component: "ibm-vpn-gateway" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# IBM Cloud VPN for VPC: an "IPsec site-to-site tunnel between your VPC and your on-premises
# private network or another VPC", in route-based mode (static routes or BGP-learned routes,
# active-backup or active-active) or policy-based mode (active-standby, no BGP)
# ("About site-to-site VPN gateways"). Neither the mode nor a throughput figure is documented as a
# default, so only the peer and tunnel type are set.
schemaVersion: "1"
type: "component"
id: "ibm-vpn-gateway"
kind: "vpn-gateway"
provider: "ibm"
docs: "https://cloud.ibm.com/docs/vpc?topic=vpc-using-vpn"
defaults:
  managed: true
  peerType: "site-to-site"
  tunnelType: "ipsec"
properties:
  mode:
    type: "enum"
    values: ["route-based", "policy-based"]
  haMode:
    type: "enum"
    values: ["active-backup", "active-active", "active-standby"]
```

Human page: https://localhost:3000/catalogue/components/ibm-vpn-gateway