Network port configurations
All Redis Enterprise Software deployments span multiple physical/virtual nodes. You’ll need to keep several ports open between these nodes. This document describes the various port ranges and their uses.
Ports and port ranges used by Redis Enterprise Software
Redis Enterprise Software’s port usage falls into three general categories:
- Internal: For traffic between or within cluster nodes
- External: For traffic from client applications or external monitoring resources
- Active-Active: For traffic to and from clusters hosting Active-Active databases
Protocol | Port | Connection Source | Description |
---|---|---|---|
TCP | 8001 | Internal, External | Traffic from application to Redis Enterprise Software Discovery Service |
TCP | 8070, 8071 | Internal, External | Metrics exported and managed by the web proxy |
TCP | 8443 | Internal, External | Secure (HTTPS) access to the management web UI |
TCP | 9081 | Internal | Active-Active management (internal) |
TCP | 9443 (Recommended), 8080 | Internal, External, Active-Active | REST API traffic, including cluster management and node bootstrap |
TCP | 10000-19999 | Internal, External, Active-Active | Database traffic |
UDP | 53, 5353 | Internal, External | DNS/mDNS traffic |
ICMP | * | Internal | Connectivity checking between nodes |
TCP | 1968 | Internal | Proxy traffic |
TCP | 3333-3341, 3342-3344, 36379, 36380 | Internal | Internode communication |
TCP | 20000-29999 | Internal | Database shard traffic |
TCP | 8002, 8004, 8006 | Internal | Default system health monitoring (envoy admin, envoy management server, gossip envoy admin) |
TCP | 8444, 9080 | Internal | Traffic between web proxy and cnm_http/cm |
Change the admin console port
The Redis Enterprise Software admin console uses port 8443, by default. You can change this to a custom port as long as the new port is not in use by another process.
To change this port, run:
rladmin cluster config cm_port <new-port>
After changing the Redis Enterprise Software web UI port, you must connect any new node added to the cluster to the UI with the custom port number:
https://newnode.mycluster.example.com:
<nonstandard-port-number>
Change the envoy ports
For system health monitoring, Redis uses the following ports by default:
-
Port 8002 for envoy admin
-
Port 8004 for envoy management server
-
Port 8006 for gossip envoy admin
You can change each envoy port to a custom port using the rladmin cluster config
command as long as the new port is not in use by another process. When you change envoy_admin_port
, expect a restart of envoy.
To change the envoy admin port, run:
$ rladmin cluster config envoy_admin_port <new-port>
Updating envoy_admin_port... restarting now
To change the envoy management server port, run:
$ rladmin cluster config envoy_mgmt_server_port <new-port>
Cluster configured successfully
To change the gossip envoy admin port, run:
$ rladmin cluster config gossip_envoy_admin_port <new-port>
Cluster configured successfully
Change the REST API port
For the REST API, Redis Enterprise Software uses port 9443 (secure) and port 8080 (not secure), by default. You can change this to a custom port as long as the new port is not in use by another process.
To change these ports, run:
rladmin cluster config cnm_http_port <new-port>
rladmin cluster config cnm_https_port <new-port>
Require HTTPS for API endpoints
By default, the Redis Enterprise Software API supports communication over HTTP and HTTPS. However, you can turn off HTTP support to ensure that API requests are encrypted.
Before you turn off HTTP support, make sure you migrate any scripts or proxy configurations that use HTTP to the encrypted API endpoint to prevent broken connections.
To turn off HTTP support for API endpoints, run:
rladmin cluster config http_support disabled
After you turn off HTTP support, traffic sent to the unencrypted API endpoint is blocked.
HTTP to HTTPS redirection
Starting with version 6.0.12, you cannot use automatic HTTP to HTTPS redirection.
To poll metrics from the metrics_exporter
or to access the admin console, use HTTPS in your request. HTTP requests won’t be automatically redirected to HTTPS for those services.
Nodes on different VLANs
Nodes in the same cluster must reside on the same VLAN. If you can’t host the nodes on the same VLAN, then you must open all ports between them.