A modern web interface for managing Wolf - the self hosted game streaming solution that lets you stream your games to any device using the Moonlight client.
|
Client Management Manage paired devices and handle new client pairing requests |
User Management Create and manage user accounts with role-based permissions |
System Settings Configure Wolf settings, metadata providers, and system preferences |
System Logs Monitor Wolf container logs and troubleshoot issues in real-time |
Before setting up WolfManager, you'll need a working Wolf installation.
⚠️ IMPORTANT: Wolf Socket Must Be EnabledWolfManager requires access to the Wolf UNIX socket to function correctly. If the socket is not available at
/var/run/wolf/wolf.sock, key features like session listing and client management will not work.To enable the Wolf socket:
Set the
WOLF_SOCKET_PATHenvironment variable in your Wolf container:-e WOLF_SOCKET_PATH=/var/run/wolf/wolf.sockMount the socket location to the host machine:
-v /var/run/wolf:/var/run/wolfEnsure the
wolf.sockfile is created inside the container at/var/run/wolf/wolf.sock.
The easiest way to deploy WolfManager is using Docker Compose. Create a docker-compose.yml file:
services:
wolfmanager:
image: ghcr.io/games-on-whales/wolfmanager/wolfmanager:latest
ports:
- "3000:3000"
environment:
- NODE_ENV=production
- NEXTAUTH_URL=http://localhost:3000
volumes:
- /var/run/wolf:/var/run/wolf # Mount Wolf socket
- /var/run/docker.sock:/var/run/docker.sock # Mount Docker socket
- ./config:/app/config # Persist config directory
restart: unless-stoppeddocker-compose up -dAccess WolfManager at http://localhost:3000
On first login use the following credentials:
Username: admin
Password: admin
First time wizard will be triggered to prompt reset of password.
- User Management: Secure authentication with role-based access control
- Smart Device Pairing:
- Real-time pairing requests with Server-Sent Events (SSE)
- Advanced duplicate client detection with clear error messages
- Edit paired clients (name, controller type, mouse acceleration settings)
- Log Monitoring: Real-time Wolf container and application logs
- API Integration: Full Wolf API with interactive testing console
- Plugin System: Community extensions for Steam, RomM, and other game libraries
- Auto Wolf Launch: Detect system and launch Wolf with optimal configuration
- Frontend: Next.js 14, React, Tailwind CSS, Shadcn UI
- Backend: Node.js, NextAuth.js, Drizzle ORM
- Database: SQLite/PostgreSQL/MySQL support
- Real-time: Server-Sent Events for live updates
- Security: Automatic secret generation, encrypted sessions
git clone https://github.com/games-on-whales/wolfmanager
cd wolfmanager
code . # Open in VS Code
# When prompted, click "Reopen in Container"The dev container automatically:
- Installs all dependencies and tools
- Configures the development environment
- Mounts Wolf socket for API testing (note youll need a local wolf instance and check the devcontainer mounts)
VS Code Tasks Available:
Ctrl+Shift+P→ "Tasks: Run Task" → "Start Dev Server"- Pre-configured launch configurations for debugging
npm install
npm run db:migrate
npm run dev # Starts on http://localhost:3000- Documentation: Wolf Docs
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Open source software. See LICENSE for details.
Built with ❤️ for the Wolf game streaming community