Running Vuze on a server

From Elvanör's Technical Wiki
Jump to: navigation, search


  • Just emerge vuze on Gentoo. After that, you need to create symlinks else you will run into classpath problems:
cd /usr/share/vuze/lib/
ln -s /usr/share/log4j/lib/log4j.jar
ln -s /usr/share/commons-cli-1/lib/commons-cli.jar
  • Once Vuze package is installed, you can already run it in command-line mode. For this you don't need any additional plugins, and this mode is completely independent from the other control interfaces you can install.
  • A good web interface is provided via the Swing Web UI plugin (webui). Download it manually then unpack it in ~/.azureus/plugins/.


  • After that, run Vuze like this:
java -jar /usr/share/vuze/lib/Azureus2.jar --ui=console
java -cp "/usr/share/vuze/lib/Azureus2.jar:/usr/share/vuze/lib/commons-cli.jar:/usr/share/vuze/lib/log4j.jar:/usr/share/vuze/lib/bcprov.jar" org.gudy.azureus2.ui.common.Main --ui=console
  • It is better to run it inside a screen terminal.
  • To access the web GUI, remember to emerge icedtea-bin with the nsplugin USE flag on Gentoo.


  • You can restrict the web GUI access to some IPs. However, the configuration setting (Plugin.azwebui.Access) is in /root/.azureus/azureus.config but is serialized so not really easy to change.
  • There does not seem to be a way of setting that via the GUI itself, so it has to be done via the command line interface (available when you load Vuze headless):
set Plugin.webui.Access,yyy.yyy.yy.yy
  • For setting a password, use:
set Plugin.webui.Password example password
  • To read the value of a parameter, just use set without any parameter:
set Plugin.webui.Access
  • To see all parameters:


  • It seems version 4.8 (with webui version 1.7.2) does not work - it keeps asking for an HTTP password even if it is disabled in the configuration. Upgrade to Vuze 5+.