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 upWhat runs
| Service | Where | Port |
|---|---|---|
| FreeRTC relay, federated | In a Linux VM | 8788 (ws), 9443/udp (direct; opened on the router by UPnP or NAT-PMP) |
| PigeonFS storage server | In the VM | 5173 (page) |
| PigeonAI server | On the Mac itself, for its GPU | 5174 (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.
- Clone
freertc,PigeonFS,PigeonAIandPigeonStackinto one folder. - In
PigeonStack, run./pigeon up. The first run makes.envfrom.env.exampleand stops: check the folders in it, then run./pigeon upagain.
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.