Skip to content

docs: Restructure Enteprise networking. #556

Open
gavinelder wants to merge 17 commits intomasterfrom
ge/docs/firewall-config
Open

docs: Restructure Enteprise networking. #556
gavinelder wants to merge 17 commits intomasterfrom
ge/docs/firewall-config

Conversation

@gavinelder
Copy link
Copy Markdown
Contributor

@gavinelder gavinelder commented Apr 22, 2025

Currently the network configuration requirements for Cloud are within the Enterprise section as such these have been moved to the Cloud under enterprise/advanced-topics/firewall-configuration.md

The original content can be viewed at https://docs.seqera.io/platform-enterprise/25.1/enterprise/advanced-topics/firewall-configuration

Further to that for Enterprise customers self-hosting their own installation

  • Seqera Cloud requires no inbound connectivity to their environment.
  • The customers Seqera Self-Hosted instance should be allowed to communicate with licences.seqera.io on port 443 the ip addresses for this are the ones defined as ingress at https://meta.seqera.io

Enterprise Plugins & Fusion

Seqera Enterprise plugins & fusion have licence checking built-in as such it's not sufficient to only allow outbound traffic to port 443 from the Seqera Enterprise installation , they will also have to allow network traffic from the Compute Environment executing the Nextflow jobs.

Wave

If the customer is using Seqera Cloud hosted Wave and they're using the Mirror or Freeze functionality which requires Wave to store built containers within their container registry then they will have to ensure that the wave-build VPC is allowed to push to their container registry, for most cloud providers this requires additional configuration to lock down as such it's not normally a problem.

These would be the IP addresses on port 443 defined as egress at https://meta.seqera.io

If the customer would like to restrict outbound traffic from their installation they would be responsible for ensuring they allow access to Seqera Assets hosted on Cloudflare along with Nextflow assets hosted on Github artifacts along with any code hosting solutions or third party dependancies they're using such as Github / Gitlab / Artifactory.

Structure.

I have tried to follow the following structure for the networking requirements.

  • Create a distinction between platform & compute environments.
  • Give a brief simple overview.
  • Go into depth where required on a service by service basis depending on customer usage.

The main item I am trying to do with the docs is inform the customer of our networking needs and how their pipeline and external services used create different networking requirements slightly outside of the scope of our documentation as it's non-exhaustive and they should take into consideration their intended usage patterns.

In short customers only need Licence manager access & cloud info as an optional service all other items can be hosted inside their internal network and are not required for platform to function.

There is a feature of Studios which needs to talk to wave however this is not released fully and is being re-worked by the team.

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 22, 2025

Deploy Preview for seqera-docs ready!

Name Link
🔨 Latest commit dae081a
🔍 Latest deploy log https://app.netlify.com/projects/seqera-docs/deploys/69d80974e468dc0008db0b94
😎 Deploy Preview https://deploy-preview-556--seqera-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@ShahzebMahmood
Copy link
Copy Markdown
Contributor

We need to update the IP addresses listed in the documentation. I'm also wondering if it makes sense to include them there at all. Additionally, we should add a list of the services that sit behind those IPs for better clarity.

At the moment, the documentation focuses only on the Enterprise offering, but there are scenarios where Cloud customers also need access to this information, so we may want to expand the scope accordingly.

On a related note, we've recently updated meta.seqera.io to display both ingress and egress IPs, which should make it easier to surface and maintain this information. I updated this PR to show the correct IPs, which should look like below.

{
  "egress": [
    "18.169.21.18/32",
    "18.135.7.45/32",
    "18.171.4.252/32"
  ],
  "ingress": [
    "35.179.197.5/32",
    "3.11.38.17/32",
    "18.175.79.222/32"
  ]
}

Copy link
Copy Markdown
Member

@bebosudo bebosudo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seqera Cloud requires no inbound connectivity to their environment.

I'm not sure that's correct; take the case of customers who are using the wave service with mirror and/or freeze functionalities, they'd need to allowlist our egress IPs in order for wave to store images in their Container Registry of choice, or for Fusion to call home, etc

@gavinelder gavinelder force-pushed the ge/docs/firewall-config branch from 53eb7a2 to e54de3c Compare January 27, 2026 16:27
@gavinelder gavinelder changed the title docs: Move Cloud Firewall config into Cloud Folder docs: Restructure Enteprise networking. Jan 27, 2026
Copy link
Copy Markdown
Member

@bebosudo bebosudo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't a complete review, but I'll continue the discussion on slack

Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Gavin <gav.elder@gmail.com>
Copy link
Copy Markdown
Member

@bebosudo bebosudo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd probably restructure this page by moving the Platform vs CE explanation first, then the two tables with requirements, then the section about DNS/IP (both Seqera's and Cloudflare's) allowlisting, and finally the detailed explanation of each service
Requesting changes because the tables need to be updated

@justinegeffen justinegeffen added 1. Editor review Needs a language review do not merge Do not merge until this label is removed additional work req. Additional work is required/comments need to be addressed before second review content-improvement This work improves content editorially or structurally. 1. Dev/PM/SME Needs a review by a Dev/PM/SME labels Jan 31, 2026
justinegeffen and others added 10 commits March 30, 2026 15:04
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
@justinegeffen justinegeffen marked this pull request as ready for review April 1, 2026 17:23
Copy link
Copy Markdown
Member

@bebosudo bebosudo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some open questions for the wave team and some improvements to the recap tables


#### Wave container services (optional)

Required only if using Seqera Cloud-hosted [Wave](https://docs.seqera.io/wave). Specific networking requirements will vary depending on pipeline configuration and use of Wave feature set.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does Platform ever interact/pull data from CRs before submitting jobs that pull and use the images? @munishchouhan @pditommaso
Because we may need to add Cloudflare CDNs to the allowlists of the firewall rules for platform installations too (wave-cache-prod-cloudflare.seqera.io, wave-cache-prod-cloudflare.seqera.io.cdn.cloudflare.net, etc)

Required if using [Wave](https://docs.seqera.io/wave). Compute environments must access `wave.seqera.io` on port 443. If using Wave with the Mirror or Freeze functionality, your container registry must allow the Seqera-hosted Wave service to push images. For the IP addresses from which Wave will push images, see the `egress` section at [https://meta.seqera.io/v3](https://meta.seqera.io/v3).

- `wave.seqera.io`
- `community.wave.seqera.io`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- `community.wave.seqera.io`
- `community.wave.seqera.io`
- `cerbero.seqera.io`

Even though pulls don't require authentication, users still need to interact with cerbero to obtain an anonymous token to pull manifests and images

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

wait.. does wave interact with community.wave.seqera.io or should it be moved down into the "Seqera hosted container registries" section?

| `community.cr.seqera.io` | 443 | Optional | Container registry |
| `auth.cr.seqera.io` | 443 | Optional | Container registry auth |
| `cr.seqera.io` | 443 | Optional | Container registry |
| `ai.seqera.io` | 443 | Optional | Seqera AI |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `ai.seqera.io` | 443 | Optional | Seqera AI |
| `ai.seqera.io` | 443 | Optional | Seqera AI |
| `ai-api.seqera.io` | 443 | Optional | Seqera AI |
| `mcp.seqera.io` | 443 | Optional | Seqera MCP |

There are more AI services right now, but they aren't required by Platform per-se, and weren't listed in the sections above. Shall we document them or drop them?

| Domain | Port | Required | Purpose |
| --------------------------------------------------------- | ---- | ----------- | ---------------------------------------------- |
| `licenses.seqera.io` | 443 | Conditional | License validation (Fusion/Enterprise plugins) |
| `cerbero.seqera.io` | 443 | Conditional | Auth service for Community CR |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `cerbero.seqera.io` | 443 | Conditional | Auth service for Community CR |

| `nf-xpack.seqera.io` | 443 | Conditional | Enterprise plugins |
| `nf-xpack.seqera.io.cdn.cloudflare.net` | 443 | Conditional | Enterprise plugins (CDN) |
| `wave.seqera.io` | 443 | Conditional | Wave container services |
| `community.wave.seqera.io` | 443 | Conditional | Wave community services |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `community.wave.seqera.io` | 443 | Conditional | Wave community services |
| `community.wave.seqera.io` | 443 | Conditional | Wave community services |
| `cerbero.seqera.io` | 443 | Conditional | Auth service for Community CR |

justinegeffen and others added 2 commits April 2, 2026 11:53
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
justinegeffen and others added 2 commits April 9, 2026 20:23
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Co-authored-by: Alberto Chiusole <1922124+bebosudo@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1. Dev/PM/SME Needs a review by a Dev/PM/SME 1. Editor review Needs a language review additional work req. Additional work is required/comments need to be addressed before second review content-improvement This work improves content editorially or structurally. do not merge Do not merge until this label is removed draft/WIP

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants