Documentation
Run Minecraft servers without losing sight of the machine.
VyronPanel manages Minecraft servers, proxies, files, add-ons, backups, monitoring, and live consoles from one local web interface.
Use a dedicated Linux host, keep Java versions available for the Minecraft releases you run, and make sure the panel data directory is included in your machine backups.
Getting started
Install and update
The installer creates or updates the panel service while preserving existing panel data and managed server files.
curl -fsSL https://api.vyronpanel.com/download/installer | sudo bash
- Run the installer.Use an account with sudo access on the Linux host.
- Open the panel.Visit
http://HOST-IP:4170from a device on the same network. - Complete setup.Create the administrator login and store the credentials somewhere secure.
Running the same command later installs the newest published build. Stop active Minecraft servers first when possible.
Getting started
First login
The first browser session creates the local panel administrator. Later visits use the saved session until it expires or you sign out.
Local panel account
Controls access to this panel installation and its Minecraft servers.
Vyron account
Connects the installation to the Vyron dashboard. Plus and cloud features remain unavailable until enabled.
Prefer a VPN or a reverse proxy with HTTPS and additional access controls.
Servers
Create a Minecraft server
Select New Server, choose Minecraft Server, and continue through the setup wizard. The loader list is paged in groups of three.
| Loader | Best for | Add-ons |
|---|---|---|
| Paper / Purpur / Folia | Performance and server-side features | Plugins |
| Vanilla | The standard Minecraft server | Datapacks |
| Fabric / Quilt | Lightweight modded servers | Mods |
| Forge / NeoForge | Large mod ecosystems and modpacks | Mods and modpacks |
- Prepare files.The panel downloads the selected build and creates the server directory.
- Accept the EULA.Review Mojang's EULA, then explicitly accept it in the setup flow.
- Set the operator.Enter the Minecraft username. The panel resolves it and writes the player to
ops.json. - Start.The actual server process starts only after preparation has completed.
Manage
Console and files
Live console
Output streams into the console while the server runs. ANSI and Minecraft formatting are translated into readable colors. Commands are sent without a leading slash.
Multi Console lets you watch and control several running servers from one view.
File manager
Open folders, upload with drag and drop, and use the right-click menu to rename, download, or delete entries. Multiple uploads appear in the transfer queue.
Stop the server before replacing jars, worlds, or files that the process writes continuously.
Manage
Configuration
The Config tab exposes common server properties. Custom startup and Java settings stay at the top right; server configuration and required resource packs live below.
Required resource pack
Upload a resource-pack .zip to make clients download it before joining. The archive must contain pack.mcmeta at its root and may be up to 512 MB.
- Upload the ZIP.The panel stores the pack and calculates its SHA-1 hash.
- Enable required download.The panel updates
resource-pack,resource-pack-sha1, andrequire-resource-pack. - Restart the server.Minecraft reads these properties during startup.
If players join from outside your LAN, configure the panel's public URL and HTTPS reverse proxy before enabling the pack.
Manage
Add-on store
Browse the Modrinth catalog by content type, popularity, game version, and loader. Search is not limited to a recommended list; pagination loads the wider catalog.
Browse and inspect
Use the tabs for plugins, mods, modpacks, datapacks, and resource packs. View opens the full description and a Versions tab with every compatible file.
Install safely
Quick Download chooses the newest compatible build. The Versions tab gives you direct control when a server requires an older release.
Shaders are intentionally excluded from server add-ons because they belong on the player's client.
Manage
Backups and transfers
| Action | Result |
|---|---|
| Create backup | Creates a local snapshot of the selected server. |
| Restore | Replaces the server files with a selected backup after confirmation. |
| Duplicate | Creates a second managed server from the existing files. |
| Export / import | Moves a complete server as a ZIP archive. |
Cloud storage currently has a 0 GB quota. Local backups, restore, import, and export remain available.
Proxies
Proxies and routes
Create a Proxy Service from the install screen, then choose a supported proxy loader such as Velocity or BungeeCord. Proxy-specific tabs replace Minecraft-only configuration.
- Add a route.Select a managed backend server or enter its host and port.
- Choose the default.Set the server players should reach when they first connect.
- Review forwarding.Match the proxy's forwarding mode and secret with every backend.
Central voice routing is planned as a Plus feature and cannot be installed yet.
Operations
Network access
The completion screen shows the internal server address for quick copying. Devices on the same LAN can use it directly.
| Access | What you need |
|---|---|
| Same network | The host's internal IP and the Minecraft server port. |
| Internet players | Router port forwarding or a trusted tunnel, plus matching firewall rules. |
| Public panel | A domain, HTTPS reverse proxy, and strong authentication. A VPN is preferred. |
| Required resource packs | A public HTTPS URL reachable without a panel login. |
Operations
Service commands
sudo systemctl status vyron-panelsudo systemctl restart vyron-panelsudo journalctl -u vyron-panel -fEnvironment overrides
| Variable | Purpose |
|---|---|
PORT | Panel HTTP port. Default: 4170. |
VYRON_DATA_DIR | Persistent panel and server data location. |
VYRON_PUBLIC_URL | Externally reachable base URL used for generated downloads. |
Operations
Troubleshooting
| Symptom | Check |
|---|---|
| Panel does not open | Check the service status, port 4170, firewall rules, and journalctl. |
| Server exits during startup | Read the last console lines, verify the Java version, RAM limit, EULA, and loader build. |
| Console command fails | Confirm the server process is running and restart the panel service after an update. |
| Add-on will not install | Verify project type, Minecraft version, loader, dependencies, and available disk space. |
| Resource pack download fails | Test its generated URL from outside the LAN and confirm HTTPS and public URL settings. |
| Files cannot be changed | Check ownership and permissions of the configured data directory. |
Reference
Security and data
- Keep the operating system, Java, Node.js, loaders, and the panel updated.
- Back up the configured Vyron data directory, not only the application files.
- Use unique administrator credentials and do not share the panel session.
- Restrict panel access with a firewall, VPN, or authenticated HTTPS reverse proxy.
- Review third-party add-ons before installing them; server jars execute code on the host.