Overflow

How to read publications on Freenet-Hyphanet

Overflow publications live on Freenet-Hyphanet, a decentralised peer-to-peer network that has been operating since 1999. To read the full text of any Overflow publication, you need Freenet-Hyphanet running on your device. Install it once and you can read everything on the network — and you strengthen the network every time you do.

Windows

Step 1

Download the Freenet-Hyphanet installer from the official site.

Download for Windows

Step 2

Run the installer. Accept the defaults. Freenet-Hyphanet will install and start automatically.

Step 3

Your browser will open to http://127.0.0.1:8888/ — this is your private Freenet-Hyphanet interface. Complete the brief setup wizard (choose “low security” for opennet access).

Step 4

To read an Overflow publication, copy the Freenet-Hyphanet key from the publication page (it starts with KSK@overflow-) and paste it into the navigation bar at the top of your Freenet-Hyphanet interface.

The first time you fetch a publication, it may take a minute or two as the network locates and delivers the content. Subsequent reads are faster because your node caches what you have read.

Mac

Step 1

Install Java if you do not already have it. Open Terminal and run:
brew install openjdk
Or download from adoptium.net.

Step 2

Download the Freenet-Hyphanet Java installer.

Download for Mac / Linux

Step 3

Open Terminal, navigate to your Downloads folder, and run:
java -jar new_installer_offline_1503.jar
Follow the installer prompts. Choose a location (the default is fine).

Step 4

Start Freenet-Hyphanet by running ./run.sh start in the installation directory. Open your Freenet-Hyphanet browser: Open Port 8888 — this is your private gateway.

Step 5

Complete the setup wizard, then paste any KSK@overflow- key into the navigation bar to read.

Important: do not install “Freenet” from freenet.org (that is a different project). That is a different project (a Rust rewrite formerly called Locutus). It uses a different network and cannot read Overflow publications. You need Freenet-Hyphanet from hyphanet.org — the original Freenet, renamed.

macOS will block the installer. This is normal. macOS blocks applications that are not signed with an Apple certificate. To get around this:

1. Try to open the .jar file. macOS will show a warning and refuse to open it.
2. Open System Settings → Privacy & Security.
3. Scroll down. You will see a message saying the file was blocked. Click Open Anyway.
4. macOS will ask for your password. Enter it. The installer will now run.

If “Open Anyway” does not appear, open Terminal and run:
xattr -d com.apple.quarantine ~/Downloads/new_installer_offline_1503.jar
This removes the quarantine flag. Then try again.

Apple Silicon Macs (M1/M2/M3/M4) require two extra fixes. The installer ships with libraries that do not support ARM64. After installation, before starting the node:

Fix 1 — JNA library. The bundled JNA 4.5.2 lacks ARM64 support. Download newer versions and replace them:
cd ~/hyphanet
curl -L -o jna-5.14.0.jar https://repo1.maven.org/maven2/net/java/dev/jna/jna/5.14.0/jna-5.14.0.jar

curl -L -o jna-platform-5.14.0.jar https://repo1.maven.org/maven2/net/java/dev/jna/jna-platform/5.14.0/jna-platform-5.14.0.jar

Then edit wrapper.conf and change:
wrapper.java.classpath.5=jna-5.14.0.jar
wrapper.java.classpath.6=jna-platform-5.14.0.jar
Add this line after the existing wrapper.java.additional entries:
wrapper.java.additional.10=--enable-native-access=ALL-UNNAMED

Fix 2 — Wrapper detection. The startup script does not recognise arm64 as a 64-bit architecture. Edit run.sh and find the line:
'aarch64')
Change it to:
'aarch64' | 'arm64')

After both fixes, start the node with ./run.sh start and open http://127.0.0.1:8888/ in your browser.

Linux

Step 1

Ensure Java is installed:
sudo apt install default-jre (Debian/Ubuntu)
sudo dnf install java-latest-openjdk (Fedora)

Step 2

Download and run the installer:
wget https://github.com/hyphanet/fred/releases/download/build01503/new_installer_offline_1503.jar
java -jar new_installer_offline_1503.jar

Download for Linux

Step 3

Start the node: ./run.sh start

Step 4

Open your Freenet-Hyphanet browser: Open Port 8888 — this is your private gateway. Complete the wizard and paste any Overflow key to read.

Android

Android support for Freenet-Hyphanet is experimental. The Freenet Mobile app runs a full node on your phone but uses significant battery and data. It is best suited for reading on WiFi.

Step 1

Download the Freenet Mobile app from GitHub.

Download for Android

Step 2

Install the APK (you may need to enable “Install from unknown sources” in your phone’s settings).

Step 3

Open the app and let the node start. It will take several minutes to connect to the network on first run.

Step 4

Open your phone’s browser and go to http://127.0.0.1:8888/. Paste the Overflow key to read.

iOS

Freenet-Hyphanet is not currently available for iPhone or iPad. Apple’s restrictions on background processes and peer-to-peer networking make a full Freenet-Hyphanet node impractical on iOS. To read Overflow publications, use a desktop or laptop computer, or an Android device.

Once you are running

Your Freenet-Hyphanet node runs quietly in the background. Every publication you read is cached on your node, making it faster to access next time and helping other readers find it. The more people who run nodes, the faster and more resilient the network becomes.

You do not need to do anything special to maintain your node. Leave it running and it participates in the network automatically. If you close it, your cached content remains available when you restart.

To read any Overflow publication, copy the key from its page on the Universitas Scholarium and paste it into your Freenet-Hyphanet browser at http://127.0.0.1:8888/.

← Back to Overflow