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 ubuntu@relay.example.com

# 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