alh477/hydramesh
A pre release ready LISP SDK for distributed communication with comprehensive reliability patterns.
Image
Networking
Languages & frameworks
Developer tools
0
960
alh477/hydramesh repository overview
HydraMesh
High-performance P2P networking for gaming and real-time audio
Part of the DeMoD Communications Framework (DCF)
Quick Start
docker run -d \
--name hydramesh \
-p 7777:7777/udp \
-p 50051:50051/tcp \
alh477/hydramesh:latest
Features
- UDP Transport - Sub-10ms latency for gaming/audio
- Binary Protocol - 10-100x faster than JSON serialization
- Reliable/Unreliable Channels - Choose per-message delivery guarantees
- Network Stats - RTT, jitter, packet loss tracking
- USB4/Thunderbolt Transport - Beta support for 40Gbps local interconnect
- Wire-Compatible - Interoperates with Rust DCF SDK
Tags
| Tag | Description |
|---|---|
latest | Production build with Thunderbolt support |
2.2.0 | Version 2.2.0 release |
Ports
| Port | Protocol | Description |
|---|---|---|
| 7777 | UDP | Game/audio data transport |
| 50051 | TCP | gRPC API |
| 5000 | UDP | Thunderbolt control (beta) |
| 5001 | TCP | Thunderbolt data (beta) |
Configuration
Mount a custom config:
docker run -d \
-v /path/to/config.json:/etc/hydramesh/config.json:ro \
-p 7777:7777/udp \
alh477/hydramesh:latest
Environment Variables
| Variable | Default | Description |
|---|---|---|
HYDRAMESH_CONFIG | /etc/hydramesh/config.json | Config file path |
HYDRAMESH_USB4_ENABLED | true | Enable USB4/Thunderbolt |
Example Config
{
"transport": "UDP",
"host": "0.0.0.0",
"port": 50051,
"udp-port": 7777,
"mode": "p2p",
"node-id": "my-node",
"peers": ["192.168.1.100:7777"],
"optimization-level": 2
}
Usage Examples
Check Status
docker run --rm alh477/hydramesh:latest status
Show Version
docker run --rm alh477/hydramesh:latest version
P2P Cluster
# Node 1
docker run -d --name node1 -p 7777:7777/udp alh477/hydramesh:latest
# Node 2
docker run -d --name node2 -p 7778:7777/udp \
-e PEERS="host.docker.internal:7777" \
alh477/hydramesh:latest
USB4/Thunderbolt (Beta)
For Thunderbolt hardware access, run with elevated privileges:
docker run -d \
--privileged \
-v /dev:/dev:ro \
-v /sys:/sys:ro \
-p 5000:5000/udp \
-p 5001:5001/tcp \
-e HYDRAMESH_THUNDERBOLT_INTERFACE=thunderbolt0 \
alh477/hydramesh:latest
Security
- Runs as non-root user (uid 10001)
- Read-only root filesystem compatible
- Minimal attack surface (~80MB image)
- No shell in production image
Hardened Deployment
docker run -d \
--read-only \
--security-opt no-new-privileges:true \
--cap-drop ALL \
--cap-add NET_BIND_SERVICE \
-p 7777:7777/udp \
alh477/hydramesh:latest
Architecture
- Base: Debian Bookworm Slim
- Runtime: SBCL (Steel Bank Common Lisp)
- Size: ~80MB
Source Code
- GitHub: ALH477/DeMoD-Communication-Framework
- License: LGPL-3.0
Related Images
alh477/dcf-rust- Rust implementation (wire-compatible)
Support
- Issues: GitHub Issues
- Docs: DCF Documentation
Tag summary
Content type
Image
Digest
sha256:86e121ba3…
Size
484.7 MB
Last updated
about 2 months ago
docker pull alh477/hydramesh