Sharing

Islo lets you create shareable URLs for services running inside your sandbox. Share preview servers, databases, or any port with teammates or the public.

Creating a Share

$
islo share <sandbox-name> [port]

Options

Examples

$
# Share port 8080 (default)
$
islo share my-sandbox
$
$
# Share a specific port
$
islo share my-sandbox 3000
$
$
# Share with public access
$
islo share my-sandbox 8080 --public
$
$
# Share with expiration (auto-revokes after 1 hour)
$
islo share my-sandbox 3000 --ttl 1h
$
$
# Share for a demo (expires in 30 minutes)
$
islo share demo-sandbox 8080 --public --ttl 30m

TTL Duration Format

Output

Share created!
  URL: https://abc123.share.islo.dev
  Port: 8080
  Access: private (tenant members only)

Access Modes

Private Shares

Private shares require authentication. Only users who are members of your Islo tenant can access them.

$
islo share my-sandbox 8080 --private

Public Shares

Public shares are accessible to anyone with the URL. Use for demos, previews, or sharing with external collaborators.

$
islo share my-sandbox 8080 --public

Warning: Public shares expose your service to the internet. Only share ports running services you intend to be public.

Listing Shares

View all active shares for a sandbox:

$
islo shares <sandbox-name>

Example Output

Shares for my-sandbox:
  URL: https://abc123.share.islo.dev
  Port: 8080
  Access: private
  Created: 2024-01-15 10:30:00
  URL: https://def456.share.islo.dev
  Port: 3000
  Access: public
  Created: 2024-01-15 11:00:00

Revoking Shares

Remove a share to stop external access:

$
islo unshare <sandbox-name> <slug-or-url>

Examples

$
# Using the slug
$
islo unshare my-sandbox abc123
$
$
# Using the full URL
$
islo unshare my-sandbox https://abc123.share.islo.dev

Use Cases

Preview Server

Share a development server for design review:

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

Demo for Clients

Create a public preview for a client demo:

$
islo share demo-sandbox 8080 --public

Share the URL with your client - no login required.

Database Access

Share a database port for debugging:

$
# Share PostgreSQL
$
islo share my-sandbox 5432 --private
$
$
# Teammates can connect with their DB client
$
# Host: abc123.share.islo.dev
$
# Port: 5432

API Testing

Share an API endpoint for integration testing:

$
islo share api-sandbox 8000 --public

External services can now reach your sandbox API.

Quick Reference

Notes

• Shares persist until revoked, expired (if --ttl set), or the sandbox is deleted
• Multiple shares can exist for the same sandbox (different ports)
• Share URLs are unique and don’t change once created
• Deleting a sandbox automatically removes all its shares
• Use --ttl for temporary shares to avoid leaving stale access open