Agent-to-Agent Port Forwarding

Agent-to-agent port forwarding allows spaces to communicate directly with each other. This is useful for microservices architectures where one space needs to access a service running in another space (for example, a frontend space connecting to a backend API space).

Requirements

For agent-to-agent port forwarding to work:

• Both spaces must be running and have active agents
• Spaces must be in the same zone
• Spaces must be owned by the same user
• Local port must be in the range 1-65535

Commands

The following commands are run from inside a space using the knot agent:

Forward Port

Forward a port from the current space to another space:

knot agent port forward <local-port> <space-name> <remote-port>

Example:

knot agent port forward 8080 backend-api 3000

This forwards port 8080 in the current space to port 3000 in the backend-api space.

List Active Forwards

View all active port forwards from the current space:

knot agent port list

Stop Port Forward

Stop an active port forward:

knot agent port stop <local-port>

Example:

knot agent port stop 8080

Use Cases

• Microservices Communication: Connect frontend containers to backend services
• Database Access: Allow application containers to access database containers
• Service Discovery: Enable development environments that mirror production architectures