VelocityWebConsole
Control your Velocity proxy from anywhere via a web browser. No SSH, no external web server — just drop the plugin and open a URL. Perfect for VPS setups where you don't have direct terminal access.
NOTE THIS PLUGIN IS NEW AND UNDER ACTIVE DEVELOPMENT, EXPECT BUGS. PLEASE REPORT THEM TO THE PROVIDED DISCORD CHANNEL UNDER #plugin-help
🟢 SUPER Easy setup & use
- No external server — The plugin runs its own web server. No Apache, nginx, or database to install or configure.
- Three steps — Drop the jar in
plugins/, restart Velocity, then openhttp://YOUR_SERVER_IP:25580/in a browser. That's it. - Sensible defaults — Port 25580, log file auto-detected. You only need to edit
config.propertiesif you want a different port or to bind to localhost. - First login — Log in with admin / admin, set a new password when prompted, and you're in. Add more users (admin/viewer) from the Users page if you like.
✨ Features
- Live console view — See your proxy's console output in real time, streamed straight to the browser.
- Run commands — Execute any Velocity console command from the web UI.
- User management — Create multiple users with Admin (full control) or Viewer (read-only console, no command execution) roles.
- Secure by default — Passwords are stored hashed (PBKDF2) in
users.json. - HTTPS support — Serve the console over TLS. Set
use_https=truein config and provide a keystore (PKCS12 or JKS). Use a certificate from Let's Encrypt (or another CA) for your domain to avoid browser "Not secure" warnings; self-signed certs work but require clicking "Advanced → Proceed" once per browser. When using HTTPS, the session cookie isSecureand responses send HSTS so browsers stick to HTTPS. Optional HTTP redirect: setredirect_http_portso users can typehttp://yourserver:25580and get redirected tohttps://yourserver:25581(see config comments).
⚙️ Configuration
Edit plugins/velocitywebconsole/config.properties and restart the proxy for changes to take effect.
| Option | Default | Description |
|---|---|---|
port |
25580 |
Port the web console listens on (HTTPS if use_https=true, else HTTP). |
bind_address |
0.0.0.0 |
0.0.0.0 = all interfaces, 127.0.0.1 = localhost only. |
log_file |
(auto) | Path to Velocity's log file if auto-detect fails (e.g. logs/latest.log). |
use_https |
false |
Serve over HTTPS (requires keystore_path and keystore_password). |
keystore_path |
(empty) | Path to keystore file (.p12/.pfx or .jks). Relative = under plugin data dir. |
keystore_password |
(empty) | Keystore password. |
keystore_type |
PKCS12 |
PKCS12 or JKS. |
redirect_http_port |
0 |
When using HTTPS: HTTP port that redirects to HTTPS so users can type the URL without https://. Set port to the HTTPS port (e.g. 25581) and redirect_http_port to the port users type (e.g. 25580). 0 = disabled. |
🔒 Security tips
- Change the default password on first use.
- Prefer
bind_address=127.0.0.1and use SSH port forwarding if you only need access from your own machine. - Don't expose the web console port to the internet without a firewall or strong passwords.
📋 Requirements
- Velocity 3.4.x - 3.5.x proxy, built on 3.4.x API (tested on 3.5.x)
- Java 17+
