PhonePod

Solid pod on your phone. One command install for Android/Termux.

Features

• Solid Pod - Full LDP server with WebID, WAC
• Nostr Relay - Built-in NIP-01 relay
• Git Server - Clone and push via HTTP
• ~100MB RAM - Lighter than a browser tab

Quick Install (Termux)

pkg install nodejs-lts
npm install -g phonepod
phonepod start

Usage

phonepod start              # Start the pod
phonepod start --port 3000  # Custom port
phonepod tunnel user@host   # Setup SSH tunnel for public access
phonepod status             # Show configuration

Public Access

To make your pod publicly accessible, you need a relay server:

# Setup tunnel (generates SSH key, creates tunnel script)
phonepod tunnel [email protected]

# Add the printed SSH key to your relay server
# Then start tunnel with PM2:
pm2 start ~/.phonepod/tunnel.sh --name tunnel
pm2 save

Boot Persistence

Install Termux:Boot from F-Droid, then:

mkdir -p ~/.termux/boot
echo '#!/bin/bash
termux-wake-lock
pm2 resurrect' > ~/.termux/boot/start.sh
chmod +x ~/.termux/boot/start.sh

# Save current processes
pm2 start phonepod -- start
pm2 save

Endpoints

| Endpoint | Description | |----------|-------------| | http://localhost:8080/ | Solid pod root | | ws://localhost:8080/relay | Nostr relay | | http://localhost:8080/relay/info | NIP-11 relay info | | git clone http://localhost:8080/ | Git clone |

Configuration

Config stored in ~/.phonepod/config.json:

{
  "port": 8080,
  "nostr": true,
  "git": true
}

Requirements

• Android with Termux
• Node.js 18+
• For public access: relay server with SSH access

License

MIT