Initial Setup Guide

From VuzeWiki
Jump to: navigation, search


While the installation for Vuze is, all in all, pretty straight forward, we realize that if you're not very confident with computers installing anything can be daunting. This page is a quick guide to help you get Azureus up and running, so you can start downloading files and contribute to the torrent community. Vuze itself comes in several installation packages, depending on your operating system. If you've installed programs before these will likely seem familiar. If you are unfamiliar with installing applications on your Operating System or just want some hints, follow the steps below.

Installing Java (prerequisite)[edit]

You have probably already noticed that Azureus is written in Java, and you must have Java installed to use it. Having an outdated version of Java, or having more than one copy of Java installed, can cause major problems for Azureus; such as your CPU usage spiking to 100%! Before installing Azureus, we recommend you read through the Java guide and make sure it is installed correctly.

Installing Vuze on Windows[edit]

Windows, despite all of its flaws, has the redeeming quality of having the easiest installer system (assuming you're an Administrator on Windows NT/2000/XP). To install Azureus on a Windows computer:

  1. Download Vuze (Azureus) from the official download page, saving it to somewhere you can find at a later date. If you unsure, you can always save it to the desktop.
  2. Wait for the download to complete. Once it does, you can click "open" if your browser has that function, or you can find and double click the "Azureus_<version>_Win32.setup.exe" file. If you saved to the desktop then minimize everything and you should be able to find it (hint: Hitting M with the Windows Key held down will minimize all open windows).
  3. Follow the installer instructions, clicking the "Next" button when you have finished with each page.

Installing Vuze on Linux[edit]

Install from a Repository Version[edit]

CAUTION: Using repository versions of Vuze can cause problems, as they are usually modified to some extent. E.g. Ubuntu modifies their version. Repositories will often not have the latest version of Vuze, however they should contain a version known to be stable. If you want to ensure that you get the latest version, see the section on installing manually.

From Synaptic (graphical package manager):[edit]

(LinuxMint,Ubuntu,Debian | .deb-installation-like)

Note: To find Vuze in Synaptic, your repositories must be correctly configured. If you cannot find Vuze, consult the documentation for your distribution or use the section on installing manually.

  1. Start Synaptic Package Manager from your Linux desktop Menu. Its exact location will depend on your setup but it is generally under "Administration" or "System".
  2. Enter your password when prompted.
  3. Look up the Vuze package maintained by your distribution by typing "Vuze" into the search bar.
  4. Mark the checkbox to the left of the package for installation.
  5. Click on the Apply button in the toolbar at the top of the window.
  6. Another pop-up window will appear to notify you of all the changes that will be made, what will be downloaded, installed and sometimes removed or upgraded. Click the "Apply" button to start the installation.
  7. Once Synaptic downloads the necessary files, the installation will begin with no further user input needed.
  8. Close Synaptic once the installation is complete.
  9. You can now launch Vuze from the menu. Depending on your system it could be under "Internet", "Network" or "Accessories".

From a Terminal with Aptitude:[edit]

(LinuxMint,Ubuntu,Debian | .deb-installation-like) --shall work as described bellow-- :

Note: To install Vuze with Aptitude, your repositories must be correctly configured. If Aptitude cannot find Vuze, consult the documentation for your distribution or use the section on installing manually.

Open a terminal window and run the following commands. If you don't know how to open a terminal window, consult the documentation for your distribution.

[This will update your computer's copy of your repositories.]

 sudo apt-get update

[This will install Vuze and ask you if any dependencies have to be installed, upgraded or removed, type Y "yes" or N for "Cancel".]

 sudo apt-get install vuze

Be aware :

  • The "sudo" command which grants installation rights might not be available in your distribution. If it is not, consult your distribution's manual to determine how to run commands as root.
  • Installation problems may be a result of the way Java is configured on your system. For more information, see Java.

Manual install from Vuze website[edit]

Note: x86 and x86_64 tested PPC should be the same.

  1. Download platform source file from download page (or )
  2. Place Azureus_(version)_Linux-(platform).tar.bz2 in directory where you want to install Vuze

    cp Azureus_(version)_Linux-(platform).tar.bz2 /directory/to/install/in/.

  3. Untar the file

    tar -xjf Azureus_(version)_Linux-(platform).tar.bz2

  4. Make sure you have Java in your path if necessary

    export PATH=/path/to/java/bin:$PATH

  5. Change to that directory

    cd vuze

  6. Run script


  7. Follow setup directions

To go further with system integration:

Note: If you wish to add Vuze to your /usr/bin directory you need to redirect it with a script, like below, rather than linking it.

This script will add Vuze to your /usr/bin directory and provide integration with the system app launcher. Replace "/path/to/vuze" by your path to vuze file.

 printf '%s\n' '#!/bin/bash' '/path/to/vuze "$@"' | sudo tee /usr/bin/vuze
 sudo chmod +x /usr/bin/vuze
 echo -e "\nNoDisplay=false\n" >> vuze.desktop
 sudo cp vuze.png /usr/share/pixmaps/
 sudo cp vuze.torrent.png /usr/share/pixmaps/
 sudo cp vuze.schemas /usr/share/pixmaps/
 sudo cp vuze.desktop /usr/share/applications

Installing Vuze on Mac OS X[edit]

  1. Download the latest version of Azureus from Sourceforge
  2. Mount the downloaded disk image
  3. Accept the GPL license agreement
  4. Drag the file to your application directory and double click it.

Getting 'Could not create this file' permissions errors? See Installing_Vuze

Setup and Optimization[edit]

A good setup is vital for your download speed and the bit-torrent community as a whole. Here are some simple points that should be followed after a fresh install of Azureus.

When you first run Azureus, the "Configuration Wizard" pops up, asking for some basic information. Using these settings is OK (especially if you don't know your upload bandwidth), but ideally you will want to optimize them for your specific connection. If you know your connection speed, go ahead and select it. Otherwise just leave it and follow the Connection Settings guide.

Note: "adsl/cable xxx/128 kbps" setting refers to a broadband connection with any download speed, but only 128 kbps upload.

Choosing a Port[edit]

Once you have (or haven't) finished with the Transfer and Connection page, click Next and you will see the NAT/Server port page. Here you can select the port Vuze uses to listen for incoming connections. It is best to change the port number from the default 6881, because some trackers blacklist it, for reasons better explained on that page.

Pick a number between 49160 and 65534, and enter it into the box. Hit the "Test" button.

If the test returns:

"Testing port 59298 ... OK !"

Then you can skip the entire Connectivity section and go to Connection Settings.


If your NAT/Firewall test says:

Testing port XXXXX ... NAT Error

Then you have a small problem: the listening port is closed and Azureus will be unable to accept incoming connections. This will limit the number of peers you can connect to, because you won't be able to make outgoing connections to other peers with NAT errors (ie, neither peer responds when trying to open a connection). This is normally caused by one of two things.

Port Forwarding for Routers[edit]

If your router doesn't know where to send the incoming connections, you will need to tell it. If you know how to do port forwarding, tell your router to forward the port you selected earlier (shown on Tools > Options > Connection) for both TCP and UDP protocols. If you are unfamiliar with port forwarding, there is a far more in-depth guide about NAT problem. Remember: you will need a static Local IP for port forwarding.

Opening Ports for Firewalls[edit]

Another common connectivity problem is caused by firewalls rejecting connections, even when they reach your computer. If this is the case, you will need to change your firewall settings to either allow the process Azureus.exe complete access to the internet, or allow the port you selected earlier. Further more detailed information about Firewalling.

Connection Settings[edit]

This is the final part of your setup, and, sadly, the downfall of most users. Read some more about Good settings.

There are a few basic things to do. The one that will affect you most is your upload limit. This should be set to roughly 80% of your actual upload ability (note: not what your ISP says you have). You can check your upload bandwidth at websites like DSLreports (US) or TestMy.Net (EU). You may want to run the test a few times to check the results for errors.

There are many connection efficiency settings that can be altered. To make it easier for you, The_8472 has written a calculator for all the settings. Just enter your upload results in the "Required data" section, and type the connection settings back into Azureus.


You need to start using Azureus!