Download Freenet

Important note for first time users

For best performance, Freenet will run continually. It should not interfere with your computer usage, as it requires around 200MB of RAM and 10% of one CPU core, plus some disk access. We strongly recommend you shut down Freenet while playing computer games etc. On Windows you can do this from the system tray icon, on other systems use the links on the system menu or the desktop.

Normally Freenet will connect automatically and should "just work", automatically connecting to other nodes (Strangers). However, if you know several people who are already using Freenet, you can enable high security mode and add them as Friends, so Freenet will only connect to them, making your usage of Freenet almost undetectable, while still being able to access the rest of the network through their friends' friends etc. This will be slower unless you add 10+ friends who are usually online when you are.

Installation Instructions

Show instructions for: Windows , Mac OSX, Linux etc

Windows

- Download and run the installer (8MB)

It will automatically install Freenet and other required components for you. When done, your default browser will automatically open up to Freenet's web-based user interface.
(Freenet contains NO spyware or adware , it's Free Software! The source code is publicly available for review)

Freenet works best with Windows XP Professional or Vista. Some problems have been reported with the installer on Windows 7, this will be fixed soon. Freenet will not run on anything older than Windows 2000 Professional (i.e. 95/98/ME), and in any case you should not run an operating system for which security support has been discontinued.

Mac OSX

Install Freenet 0.7 using JavaWebStart.
If this doesn't work, try the linux instructions.

Linux and other Unix-like systems

Try the JavaWebStart installer.
If it doesn't work, please try the instructions given below.

You need to have a recent Java Runtime Environment (JRE). We have experienced best results with Sun's Java Runtime Environment which can be obtained via your package manager or from http://www.java.com/.

Java version 1.5 and later will work. However, be aware that there are applet security vulnerabilities in all versions prior to Java 1.5 update 4. Generally, we recommend using latest. Also, you will need wget for the below commands to work (on Ubuntu, apt-get install wget).

Open a terminal and type:

	  wget http://freenet.googlecode.com/files/new_installer_offline_1240.jar -O new_installer_offline.jar
	  java -jar new_installer_offline.jar

Alternatively, downloading the installer (gpg signature) and then clicking on the file may work on some systems, but if there are problems we recommend the above command lines.

Headless install

Or do the following on a headless system:

	  wget http://downloads.freenetproject.org/alpha/installer/freenet07.tar.gz
	  tar xvzf freenet07.tar.gz
	  cd freenet
	  ./run.sh start

Read the FAQ on how to enable web-access from a remote computer.

Note that this will not install the system tray icon or desktop/menu shortcuts, so you should open Freenet manually in a web browser:

	http://127.0.0.1:8888/

Note also that most people use the GUI installer - use that if you can. The scripts in the headless installer can be a bit unreliable, so try again if it doesn't work the first time. And you must have Sun Java installed and set as default (man update-java-alternatives on debian/ubuntu) before you install.

Mirrored installation

If you have a working Freenet installation directory that you have mirrored from one Unix machine to another (e.g. via rsync or unison), enabling the mirrored installation is not difficult. Nothing in a Freenet installation cares about its host's IP address; it can't, or Freenet would fail on machines that get IP addressss from a DHCP pool

All you actually need to do is tell the system you've mirrored to that it should start the Freenet proxy daemon for you on boot. Do crontab -l on the source machine, find the line that is tagged "FREENET AUTOSTART" and add that to your crontab on the mirrored machine.

However: each installation has a unique identity key generated at installation time. If you try to run two instances with the same identity at the same time, both proxy demons will become confused and upset. Don't do this!

HOWTO

You might find the mini-howto useful (it might be of interest to Windows users too).

Firewalls and routers

Freenet should work fine with most routers, but if you are having problems and you have a firewall or router, click here for some info.

So it's running, what do I do?

When the installer closes, it should open a browser window pointing to the first-time wizard. Here you can configure basic settings, and then start using Freenet. You can access Freenet later on via the system tray menu (bottom right on the screen), or use the Browse Freenet shortcut on the desktop and/or start menu. If it doesn't work, open http://127.0.0.1:8888/ in your web browser.

For best security you should use a separate browser for Freenet, preferably in privacy mode. On Windows, the system tray menu will try to use Chrome in incognito mode if possible. Internet Explorer does not work well with Freenet, Firefox and Opera are widely used.

If you know anyone running Freenet, you can improve your security and help to build a robust network by connecting to their node. First, open the Add a friend page. You and your friend should each download their "node reference". Send the file to the other person, and add his node reference using the form at the bottom of the page. When both are added, your friend's node should show up on the Friends page, probably as "CONNECTED" or "BUSY". You can set a name for your node on the config page to make it easier to see who it is. Only add nodes run by people you actually know, whether online or offline, as adding total strangers harms performance and does not improve security much (they could be the bad guys!).

So I'm connected, what do I do?

Freenet itself includes anonymous websites ("freesites"), filesharing, searching, and more, but you can also use third party applications for chat, filesharing, to help you upload freesites, etc.

It doesn't work, now what?

If you have problems installing or running Freenet, please contact us on the support list (subscribe here), or join us on IRC on the #freenet channel on irc.freenode.net (try here).

Hardware requirements

Generally a 1GHz processor and 1GB of RAM should be fine. Freenet will run on smaller systems, but it uses at least 128MB of RAM, so unless the system does nothing else it will struggle in less than 512MB. However, the processor is less of a problem, people have been known to run it on 400MHz Pentium 2's or ATOM's, although downloads and browsing would be slow.

Freenet will use a portion of your disk for storing data, you can configure this to any size from 100MB upwards, but we recommend at least 1GB. Freenet also uses disk space for your downloads. Freenet's memory usage is approximately 192MB plus 1MB for every 2GB of datastore.

On 64-bit Windows, we will install a 32-bit Java Virtual Machine because of limitations of the Java Service Wrapper. This will not necessarily auto-update itself, so you may need to update it occasionally.

Upgrading

Freenet provides now an update-over-freenet mechanism: It will keep itself up to date automatically from other Freenet nodes, and this will normally work even if it is unable to route to them due to them being too new. This is anonymous and secure, and we recommend people use it. However, if something is severely broken, you can update your node manually from our servers:

Source Code: See the developer page for git access, or download the lastest stable tarball here.

Send spam to catchme@freenetproject.org ! :)