Skip to content

PigeonStack Coming soon ​

One command runs a federated FreeRTC relay, a PigeonFS storage server and a PigeonAI server together, on an Apple silicon Mac:

bash
./pigeon up

GitHub

What runs ​

ServiceWherePort
FreeRTC relay, federatedIn a Linux VM8788 (ws), 9443/udp (direct; opened on the router by UPnP or NAT-PMP)
PigeonFS storage serverIn the VM5173 (page)
PigeonAI serverOn the Mac itself, for its GPU5174 (page)
  • Its own address on your network. The VM is bridged onto the Mac's network, so phones and computers on the same network reach the relay and the servers directly.
  • Nothing on the Mac's internal disk. The VM, its downloads and every service's data go in folders you choose; an external drive is fine.
  • Each service restarts by itself if it stops.

Set up ​

Needs an Apple silicon Mac with macOS 14 or later, and Homebrew.

  1. Clone freertc, PigeonFS, PigeonAI and PigeonStack into one folder.
  2. In PigeonStack, run ./pigeon up. The first run makes .env from .env.example and stops: check the folders in it, then run ./pigeon up again.

It installs Lima and krunkit, asks for your password once (for the VM's network), makes the VM, and starts the three services. ./pigeon update brings everything up to date.

peer.ooo · peer to peer on PeerPigeon