Get peerfuse

To join the network, you first have to get the peerfuse software. You can download it here:

You need to compile peerfuse-net. Read the download page to get more information.

Create workspace

peerfuse-net binary is in the build.peerfuse-net/ directory. You can create a workspace:

$ mkdir network

Now cd into it and create some required directories:

  • cache/, to store read files and your files on network.
  • work/, to save some configuration files created by peerfuse.
  • mnt/, the mount point of the filesystem.


Copy the pfnet.conf file to your network/ directory, and edit it.

The port listening

You need to open a port to allow other peers to connect to you. Default port is 1777, but it can be what you want...

If you are behind a NAT router, please forward the port to your host.

Connection to a peer

The connect block must be used to specify a peer on network where you want to connect to. There are actually some permanent peers:


To connect to the network, you must generate a certificate, and ask the CA to sign it.

Please read this page to know how to do.

About CRL, if peerfuse fails to get file, you can disable it.


Set root and work to the path of your created directories cache and work.


You can specify which log level you want. This option is usefull only if peerfuse is not run as a deamon.

Join network

You just have to run this command:

$ ../build.peerfuse-net/peerfuse-net pfnet.conf mnt/

You can add the -d parameter if you don't want to detach peerfuse and see log messages.

Now you can see files in the mnt/ mount point. You can read them (for example a music with mplayer), create some files, etc.

Have fun!

© 2008 Laurent Defert, Romain Bignon
$Id: howto.html 1067 2008-05-11 19:34:40Z dehy $
Valid XHTML 1.1 and CSS.
Thanks to for this website.