---
id: "submariner"
type: "component"
kind: "vpn-gateway"
provider: "default"
category: "edge"
docs: "https://submariner.io/getting-started/"
url: "https://localhost:3000/catalogue/components/submariner"
---

# Submariner

Connects pod and service networks of separate Kubernetes clusters over IPsec tunnels.

| | |
|---|---|
| Provider | [default](https://localhost:3000/catalogue?provider=default) |
| Kind | [VPN gateway](https://localhost:3000/catalogue/kinds/vpn-gateway) |
| Category | Edge |
| Official docs | [https://submariner.io/getting-started/](https://submariner.io/getting-started/) |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `activeActive` | boolean | — | no | false | **false** |
| `bgp` | boolean | — | no | false | **false** |
| `cableDriver` | enum | `libreswan`, `wireguard`, `vxlan` | no | "libreswan" | inherited |
| `globalnet` | boolean | — | no | false | inherited |
| `managed` | boolean | — | no | false | **false** |
| `peerType` | enum | `site-to-site`, `point-to-site`, `cloud-to-cloud` | no | — | **"cloud-to-cloud"** |
| `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
- [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
- [IBM Cloud VPN for VPC](https://localhost:3000/catalogue/components/ibm-vpn-gateway.md) `ibm-vpn-gateway` — ibm
- [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: "submariner", component: "submariner" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# Submariner: connects the pod and service networks of separate Kubernetes clusters through a
# gateway node in each cluster. Per the Submariner documentation the default cable driver builds
# IPsec tunnels with Libreswan, and overlapping CIDRs need Globalnet, which is off by default.
schemaVersion: "1"
type: "component"
id: "submariner"
kind: "vpn-gateway"
provider: "default"
docs: "https://submariner.io/getting-started/"
defaults:
  managed: false
  peerType: "cloud-to-cloud"
  tunnelType: "ipsec"
  bgp: false
  activeActive: false
properties:
  cableDriver:
    type: "enum"
    values: ["libreswan", "wireguard", "vxlan"]
    default: "libreswan"
  globalnet:
    type: "boolean"
    default: false
```

Human page: https://localhost:3000/catalogue/components/submariner