-
Notifications
You must be signed in to change notification settings - Fork 82
Home
Muximux is a modern, self-hosted web application portal for your homelab. It runs as a single binary, serves on a single port, and stores all configuration in one YAML file. Add your self-hosted applications, organize them into groups, and access them from a unified dashboard with health monitoring, keyboard shortcuts, and a built-in reverse proxy.
Muximux is designed to fit your setup, from a simple dashboard to a full reverse proxy appliance.
Dashboard only -- Run Muximux behind your existing reverse proxy (Traefik, nginx, Caddy, etc.) with auth: none and let your proxy handle TLS and authentication. Apps open via their direct URLs or in iframes. This is the simplest setup.
Dashboard + built-in reverse proxy -- Same as above, but enable proxy: true on apps that don't work in iframes. Muximux proxies those apps through /proxy/{slug}/, stripping iframe-blocking headers and rewriting paths. This works in all deployment modes -- no extra configuration needed.
Full reverse proxy appliance -- Use Muximux as your only reverse proxy. Configure tls.domain for automatic HTTPS and a gateway Caddyfile to serve your other services on their own domains. Caddy handles TLS certificates, HTTP-to-HTTPS redirects, and routing -- all from one binary. See TLS & HTTPS for a full walkthrough.
- Installation -- Docker, binary, and building from source
- Getting Started -- First launch, onboarding wizard, and initial setup
- Configuration Reference -- Full config.yaml format and all available options
- Apps -- Adding, configuring, and managing applications
- Built-in Reverse Proxy -- Proxying app traffic through Muximux
- Authentication -- Built-in auth, forward auth, and OIDC
- TLS & HTTPS -- Automatic certificates, custom certificates, and gateway mode
- Navigation & Layout -- Sidebar positions, auto-hide, labels, and display options
- Themes -- Built-in themes, custom themes, and CSS custom properties
- Health Monitoring -- Automatic health checks and status indicators
- Keyboard Shortcuts -- Default shortcuts and custom keybindings
- Icons -- Dashboard Icons, Lucide icons, custom icons, and caching
- Deployment Guide -- Production deployment, reverse proxies, and networking
- Troubleshooting -- Common issues and solutions
- API Reference -- REST API endpoints for programmatic access