Secure communication between your services in the cloud

Connect your applications, add-ons and external machines within an encrypted private network

Your services communicate directly over all the ports they need, without having to expose those ports to the Internet or manage a VPN.

A private network managed by Clever Cloud

One approach is to connect these services within a private overlay network built on top of the physical network. Communications are encrypted by default using WireGuard, with no low-level networking layer to manage and no tunnels to deploy. On Clever Cloud, Network Groups implement this approach.

For more details on how it works: How to create a private network between applications in the cloud (without managing a VPN)

Traditional architecture (services exposed to the Internet) vs architecture with a private network (private internal communication)

schéma landing page ENG

Network Groups at a glance

A Network Group is an encrypted private network that connects your Clever Cloud resources (applications and add-ons) as well as machines outside the platform. Once they have joined the same group, members can communicate directly with one another over their internal ports, without having to expose those ports to the Internet.

You specify which resources need to communicate; Clever Cloud sets up the network.

Benefits

Encrypted traffic by default

All traffic between members is encrypted using WireGuard, with no action required on your part.

All ports available internally

Each service can be reached on any port within the group, not only through a public endpoint.

Automatically configured network

Each member automatically receives a private IP address and an internal domain name.

Multi-zone reach

A single network can connect resources hosted across different zones and data centres.

Support for external resources

A third-party server or an on-premises machine can join the private network.

Included at no extra cost

Network Groups are available at no additional cost.

How it works

Each resource connected to a Network Group receives an IP address from a dedicated CIDR range, as well as an internal domain name. Members can then reach one another using this name, over any port. Communications travel through encrypted WireGuard tunnels: services communicate over the private network without having to expose their ports to the Internet.

Three interfaces are available for creating and managing a group, depending on your workflow: the Clever Cloud Console, Clever Tools (CLI) and the public API.

Use cases

Network Groups are not a standalone solution, but a mechanism that enables certain secure architectures.

Deploying Keycloak for high availability

Multiple Keycloak nodes synchronise to form an IAM cluster. Their communications travel over an encrypted private network, without exposing inter-node traffic publicly.

Protecting applications behind an API Gateway

Only the gateway is publicly exposed. The backend services remain accessible to it over the private network, but cannot be reached from the Internet: no public ports are open on the internal applications.

Secure communication between microservices

In a distributed architecture, only the entry points that genuinely need to be public are exposed. Service-to-service communications travel privately, with no open ports or tunnels to configure.

Hybrid architecture and connections to external machines

A single encrypted private network can connect Clever Cloud resources distributed across multiple zones, as well as external servers, whether they are hosted by another provider or within your own infrastructure.

Private networking as a platform capability

On a PaaS, network management should not be a project in itself. Network Groups embody this principle: describe an architecture rather than configure infrastructure. Create and manage your Network Groups from the Console, Clever Tools or the public API, without having to build or administer the underlying network infrastructure.

FAQ

When should you use a private network between applications?

This architecture is particularly suitable for application clusters, microservices architectures and internal APIs.

Do you need to deploy a VPN to connect your applications on Clever Cloud?

No. Network Groups use WireGuard, but there is no VPN server to install and no tunnel to manage: the platform manages the encrypted private network for you.

Are Network Groups included at no extra cost?

Yes. They are available at no additional cost as part of the Clever Cloud service.

Can Network Groups be managed without using the command line?

Yes. They can be managed through Clever Tools (CLI), the public API and, since May 2026, directly from the Clever Cloud Console.