Common issues and solutions when working with Seed Hypermedia.
Daemon Issues
Won't start: Check if already running (pgrep -f seed-daemon)
Port conflict: Default is 55002 (lsof -i :55002)
Headless mode: Use SEED_FILE_KEYSTORE=1 for servers
Key Problems
Key not found: Check ListKeys output for available keys
Wrong key name: Key names are case-sensitive
Publishing Issues
Not appearing on gateway: Push directly with PushResourcesToPeer
Empty blocks: Block types must be PascalCase (Paragraph, not paragraph)
Corrupt documents: Usually caused by lowercase block types
Network Issues
Can't fetch remote docs: Try ForceSync to pull from network
Gateway unreachable: Check https://hyper.media/hm/api/config
Debugging Checklist
1. Daemon running? pgrep -f seed-daemon
2. gRPC works? grpcurl -plaintext localhost:55002 list
3. Have the key? Check ListKeys output
4. Pushed to gateway? Use PushResourcesToPeer