mirror of
https://github.com/Shik3i/KoalaSync.git
synced 2026-07-28 04:49:09 +00:00
MacBook
3e2e9ed7a5
- Integrated 'Koala-Bridge' for seamless web-to-extension communication. - Implemented dedicated, minimalist invitation page (join.html). - Added brute-force protection and RAM-cleanup to the relay server. - Removed external fonts and trackers from the landing page (Privacy First). - Unified header/footer design across all website pages. - Added MIT License and comprehensive legal documentation (Impressum/Datenschutz).
KoalaSync Relay Server
A high-performance Node.js relay server for synchronized video playback.
Key Features
- Zero-Persistence: No database. All state is held in RAM.
- Privacy First: No tracking, no logging of user data.
- WebSocket Only: High performance with minimal overhead.
Setup
Environment
Copy .env.example to .env and configure your settings.
PORT=3000
MAX_ROOMS=100
MAX_PEERS_PER_ROOM=20
MIN_VERSION=1.0.0
Docker (Recommended)
The server is designed to run in a Docker container.
# Build from the repository root
docker build -t koala-sync-server -f server/Dockerfile .
Manual Setup
cd server
npm install
npm start
Security
- Rate Limiting: IP-based connection limits and socket-based event limits.
- Token Handshake: Requires a valid token defined in
shared/constants.js. - In-Memory: Rooms are automatically pruned after 2 hours of inactivity.