Skip to content

ssinjinx/paperclip-mobile

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Paperclip Mobile

Make the Paperclip dashboard accessible from any web browser — local network and internet.

Access URLs

Method URL Status
Localhost http://localhost:3100 ✅ Working
Local Network http://192.168.68.54:3100 ✅ Working
Cloudflare Tunnel https://paperclip.siliconsoul.cloud ⏳ Needs tunnel token

Quick Start — Remote Access via Cloudflare Tunnel

Option A: Zero Trust Token (Recommended — No browser login required)

  1. Go to Cloudflare Zero Trust → Networks → Tunnels → Create a tunnel
  2. Choose Cloudflared connector type
  3. Name the tunnel: paperclip
  4. Select Linux 64-bit environment
  5. Copy the token from the install command (the long string after --token)
  6. Run:
    TUNNEL_TOKEN=<your-token> ./setup-tunnel.sh

Option B: Browser Login (Named tunnel)

cloudflared tunnel login   # Opens browser to authenticate
./setup-tunnel-named.sh    # Creates named tunnel + DNS route + service

Config

Server config: ~/.paperclip/instances/default/config.json

Current settings:

  • Host: 0.0.0.0 (all interfaces)
  • Port: 3100
  • Exposure: public
  • Auth base URL: https://paperclip.siliconsoul.cloud
  • Allowed hostnames: localhost, 192.168.68.54, paperclip.siliconsoul.cloud

After Tunnel is Running

Your Paperclip dashboard will be available at https://paperclip.siliconsoul.cloud from any device on any network.

  • Check tunnel status: sudo systemctl status cloudflared
  • View logs: sudo journalctl -u cloudflared -f
  • Restart: sudo systemctl restart cloudflared

Reverting to Localhost Only

Edit ~/.paperclip/instances/default/config.json:

  • Change "exposure": "public""exposure": "private"
  • Change "host": "0.0.0.0""host": "127.0.0.1"
  • Remove "publicBaseUrl" and "baseUrlMode" from auth
  • Restart Paperclip

Files

File Purpose
setup-tunnel.sh Zero Trust token-based setup (recommended)
setup-tunnel-named.sh Named tunnel setup (after cloudflared tunnel login)
setup-network.sh Local network only setup

About

Setup scripts and config to make Paperclip dashboard accessible remotely via Cloudflare Tunnel at paperclip.siliconsoul.cloud

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages