Skip to main content
Marzban is a panel on top of Xray for giving access to many users: each one gets a subscription link with all of their configs, and it updates on its own. For a few connections you manage by hand, 3X-UI is simpler.

​
Installation

Connect over SSH as root: Connection. Even a VPS-0 is enough. Commands are for Ubuntu/Debian, check the latest versions in the Gozargah/Marzban and Marzban-scripts repos.
  1. Install – the official script:
    The script downloads and starts Marzban. You get the marzban command: status, logs, restart.
  2. Administrator – the command asks for the username and password for the dashboard:
  3. Check – the status should be Up:
  4. Firewall – open the dashboard port and the ports of your inbounds, details: Firewall.

​
Access

Without SSL the dashboard doesn’t open from outside, neither by IP nor by domain: you need a domain with a certificate.
  • SSL in Marzban – get a certificate, for example from Let’s Encrypt, and set the paths in the UVICORN_SSL_CERTFILE and UVICORN_SSL_KEYFILE variables. The dashboard opens at https://YOUR_DOMAIN:8000/dashboard/.
  • Reverse proxy – put the panel behind nginx.
  • SSH tunnel – only to peek into the panel without a domain. Run on your computer:
    Then open http://localhost:8000/dashboard/ in the browser.
Details are in the Marzban documentation, issuing a certificate: SSL.

​
First user

  1. Log in – open the dashboard at your domain and log in with the admin credentials.
  2. User – add a new one and, if needed, set a traffic limit and an expiry date.
  3. Subscription – copy the user’s subscription link and pass it on. It goes into a client app, v2rayNG, NekoBox, or Hiddify: the configs are pulled in and update on their own.
You set up the software yourself, Lumi handles the server and network. If the network or a port doesn’t work, message @lumisup_robot. Next: 3X-UI, SSL certificate.