Running locally with remote access

These options let you run Privipod on your own machine and share it with others over the internet without a server.

This is only practical in the short-term; you will need to keep it running until you have transferred the secret.

ngrok

ngrok creates a temporary public HTTPS tunnel to your local machine. Free accounts get a random subdomain; paid accounts get a fixed domain.

# Install ngrok, then:
uvx privipod 0:8000

# In a second terminal:
ngrok http 127.0.0.1:8000

ngrok prints a URL like https://abc123.ngrok-free.app - share that with your sender.

Once the transfer is complete, shut down privipod and ngrok to close the tunnel.

Cloudflare Tunnel

Cloudflare Tunnel (cloudflared) creates a persistent tunnel from Cloudflare’s edge to your machine with no inbound firewall rules required.

# Install cloudflared, authenticate once:
cloudflared login

# Start Privipod:
uvx privipod 0:8000

# Start the tunnel (one-off, for quick sharing):
cloudflared tunnel --url http://localhost:8000

Cloudflare prints a public HTTPS URL. For a stable named tunnel (survives restarts), follow the Named Tunnels guide.