From 659d680a76501a2db3115cf4862138fe61a8b81e Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 31 Jul 2026 08:14:10 +0000
Subject: [PATCH] docs: document sandbox port publishing policy

---
 celesto-sdk/cli.mdx                    | 4 +++-
 celesto-sdk/computers.mdx              | 4 ++++
 celesto-sdk/features/publish-ports.mdx | 4 ++++
 3 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/celesto-sdk/cli.mdx b/celesto-sdk/cli.mdx
index cd51911..6d77ec7 100644
--- a/celesto-sdk/cli.mdx
+++ b/celesto-sdk/cli.mdx
@@ -137,10 +137,12 @@ celesto computer port unpublish einstein --port 8000
 
 | Command | Description |
 |---|---|
-| `celesto computer port publish NAME [--port N]` | Expose a port on the public internet. Defaults to `8000` |
+| `celesto computer port publish NAME [--port N]` | Expose an application port (`1024`–`65535`) on the public internet. Defaults to `8000` |
 | `celesto computer port list NAME` | List published ports for a computer |
 | `celesto computer port unpublish NAME [--port N]` | Stop exposing a port. Defaults to `8000` |
 
+A computer can have up to four ports published at a time, and Celesto system ports are reserved for the platform.
+
 ## Auto-resume stopped computers
 
 The `run` and `ssh` commands automatically resume a stopped computer before executing. You can run a command or open a terminal session without calling `start` first.
diff --git a/celesto-sdk/computers.mdx b/celesto-sdk/computers.mdx
index f0ddbdb..03a5550 100644
--- a/celesto-sdk/computers.mdx
+++ b/celesto-sdk/computers.mdx
@@ -179,6 +179,8 @@ print(f"Total: {len(computers)}")
 
 Publishing a port gives your computer a public HTTPS URL. Use it when an app, API server, or notebook running inside the computer needs to be reachable from outside the sandbox.
 
+Pick any application port from `1024` through `65535`. A computer can have up to four ports published at a time, and Celesto system ports are reserved for the platform.
+
 ```python publish_port.py
 from celesto import Computer
 
@@ -442,6 +444,8 @@ console.log(`Total: ${computers.length}`);
 
 Publishing a port gives your computer a public HTTPS URL. Use it when an app, API server, or notebook running inside the computer needs to be reachable from outside the sandbox.
 
+Pick any application port from `1024` through `65535`. A computer can have up to four ports published at a time, and Celesto system ports are reserved for the platform.
+
 ```ts publish-port.ts
 import { Computer } from "@celestoai/sdk";
 
diff --git a/celesto-sdk/features/publish-ports.mdx b/celesto-sdk/features/publish-ports.mdx
index e2cf8f0..9f099dc 100644
--- a/celesto-sdk/features/publish-ports.mdx
+++ b/celesto-sdk/features/publish-ports.mdx
@@ -19,6 +19,10 @@ Publish a port when you need to:
 - Receive webhooks during a test run.
 - Inspect a notebook, dashboard, or development server.
 
+## What you can publish
+
+Pick any application port that your service listens on inside the computer, from `1024` through `65535`. A computer can have up to four ports published at a time — unpublish one before adding another once you reach the limit. Celesto system ports are reserved for the platform and cannot be published.
+
 ## Publish a service
 
 The following example starts a simple HTTP server on port `8000`, publishes the port, prints the public URL, lists published ports, and then removes the published port.