Running Vuze on a server

Installation

• 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/.

Running

• 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.

Configuration

• 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 xxx.xxx.xx.xx,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:

set

Troubleshooting

• 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+.