Important files

What all the files are and what they do.

Disclaimer: currently not an exhaustive list.

Table of Contents Program Config Node references User state Run-time state Storage Logs

Program

bin/, lib/

Program files needed to launch or update freenet, mostly relating to the Tanuki Java wrapper and the auto-update scripts.

license/

Licensing information.

run.sh

Freenet control shell script. (TODO windows has one, freenet.exe?)

freenet*.jar

Java packages, the core bulk of Freenet.

plugins/

Java packages for plugins, and their SHA-1 sums.

seednodes.fref

List of seed node references used for announcement.

startssl.pem

SSL certificate for freenet servers. Used by update.sh/update.cmd but also when loading a plugin from the central servers.

Files only used by the installer/updater:

freenet-latest-installer-windows.exe, freenet-latest-installer-nonwindows.jar

Official installer

update.sh

Update script, to run outside of the main Freenet daemon.

wrapper_Linux.zip

Archive containing the Tanuki Java wrapper.

sha1test.jar

Downloads files and verifies checksums

freenet*.jar.sha1, seednodes.fref.sha1, update.sha1, wrapper_Linux.zip.sha1, plugins/*.sha1

SHA-1 sums used by the install/update scripts to verify downloads.

Config

wrapper.conf, freenet.ini

The main configuration files.

freenet.l10n.*.override.properties

Language overrides, defined by the user.

Node references

seednodes.fref

List of seed node references used for announcement.

node-XXXX, peers-XXXX, opennet-ZZZZ, openpeers-ZZZZ, openpeers-old-ZZZZ

Your darknet (X) and opennet (Z) identities and peers.

User state

master.keys

Don't lose these!

node.db4o (or node.db4o.crypt)

Persistent download status (pre-1468)

client.dat (or client.dat.crypt)

Persistent downloads/uploads status (post 1468)

client.dat.bak (or client.dat.bak.crypt)

Backup of persistent downloads/uploads status

extra-peer-data-XXXX

Stuff like N2N messages.

persistent-temp-XXXX

Persistent temp files - space used by in-progress persistent downloads/uploads (also .fblob's for auto-updater)

bookmarks.dat, completed.list.downloads, completed.list.uploads

Self-explanatory.

Note that post 1468, the downloaded blocks and status information for any given download are stored in a separate file. This might be in persistent-temp, but in some cases it will be in the folder the download is being saved to (as it can then be truncated and renamed when the download is finished). It will be larger than the (compressed) file and have a similar filename ending with .freenet-tmp.

Run-time state

bootID

Changes on each startup so we can tell whether we have shutdown cleanly

prng.seed

Seed for the PRNG.

client-throttle.dat, node-throttle.dat

Used by load management

packets-XXXX.dat, packets-ZZZZ.dat,

Used by internet connectivity page

uptime.dat, uptime.old.dat

Used to determine uptime so we can tell other peers

Storage

datastore/

See Datastore

downloads/

Completed downloads.

Logs

hs_err_pidNNNN.log

Log dumped when the JVM crashes

logs/, wrapper.log*

Freenet logs and Wrapper logs.