CLI

Sharing

Islo lets you create shareable URLs for HTTP services running inside your sandbox. Use shares for preview servers, demos, or any port serving HTTP traffic.

Creating a Share

$islo share <sandbox-name> [port]
ArgumentRequiredDefaultDescription
sandbox-nameYes-Name of the sandbox
portNo8080Port to share

Options

OptionDefaultDescription
--ttl <duration>24hAuto-expire the share after this duration

Examples

$# Share port 8080 (default)
$islo share my-sandbox
$
$# Share a specific port
$islo share my-sandbox 3000
$
$# Share with a short expiration
$islo share my-sandbox 3000 --ttl 1h
$
$# Share for a demo (expires in 30 minutes)
$islo share demo-sandbox 8080 --ttl 30m
$
$# JSON output for scripting
$islo share my-sandbox 8080 --output json

TTL Duration Format

FormatDuration
30m30 minutes
1h1 hour
24h24 hours (default)
7d7 days

Output

Share created for my-sandbox:8080
  URL: https://abc123.share.islo.dev
  Expires: <Date-Time>

Listing Shares

View all active shares for a sandbox:

$islo shares <sandbox-name>

The table has four columns — SHARE ID, PORT, URL, EXPIRES. Use --output json for a machine-readable array.

Revoking Shares

Remove a share to stop external access:

$islo unshare <sandbox-name> <share-id-or-url>

Examples

$# Using the share ID
$islo unshare my-sandbox sh_abc123
$
$# Using the full URL
$islo unshare my-sandbox https://sh_abc123.example.islo

Use Cases

Preview Server

Share a development server for review:

$# Start your dev server in the sandbox
$islo use my-sandbox -- npm run dev
$
$# Share it
$islo share my-sandbox 3000

Create a short-lived URL for a client demo:

$islo share demo-sandbox 8080 --ttl 2h

Hand the URL to your client. It stops working automatically after the TTL.

API Testing

Share an HTTP API endpoint so external systems (webhooks, integration tests) can reach your sandbox:

$islo share api-sandbox 8000 --ttl 4h

Shares are HTTPS endpoints — they’re only useful for ports serving HTTP. Non-HTTP protocols (raw Postgres/Redis/SSH) won’t work over a share. For non-HTTP debugging, use islo port-forward instead.

Quick Reference

CommandDescription
islo share <name> [port]Create a share (default port 8080, default TTL 24h)
islo share <name> <port> --ttl 1hCreate a share that expires in 1 hour
islo shares <name>List active shares for a sandbox
islo unshare <name> <id-or-url>Revoke a share

Notes

  • Shares persist until revoked or expired by --ttl.
  • Multiple shares can exist for the same sandbox on different ports.
  • Share URLs are unique and don’t change once created.
  • Deleting a sandbox automatically removes all its shares.
  • Anyone with the URL can reach the shared port until it expires — pick a TTL that matches how long the share actually needs to be live.