ZeroNet

[robi]

@girish no it's entirely maintained "off clearnet", locally and within ZeroNet ecosystem. There are other unmaintained forks with repos, but they're old and buggy.

If installed on rw filesystem is can also self-update from there. It's really cool.

Not sure how to handle that yet, however the code itself checks it's own version bumps, so you can get notified of that. It might be good to run most of it from /app/data

If tor is added, it can also use it to have a tor onion service presence or just browse. There is another bundle .zip with those added as of the end of Jan.

So for this src, unzip, pip install -r requirements.txt and set a zeronet.conf with ui_host = <app hostname> and ui_ip = * so it can use the internal network and localhost.

There is also an example Dockerfile in there that uses an alpine image.

Proxying works partially which is the frustraction, because some calls work and yet others don't so the beautiful pages don't load properly, missing assets, etc, and lots of 404s in the debug log.

I tried making all those locations as exceptions in nginx config, to no avail. So I must be missing something silly.

[robi]

New version dropped today: 0NetDWFsrc v10.02.24 Rev6008.zip

Linux bundle with latest tor binaries: 0NetDWFlinux v10.02.24 Rev6008.zip

Mac bundle with latest tor binaries: 0NetDWFmac v10.02.24 Rev6008.zip

Windows bundle with latest tor binaries: 0NetDWFwin v10.02.24 Rev6008.zip

How to run:
Unzip, chmod 755 <dir>
edit zeronet.conf & nginx.conf
cd <dir>
./ZeroNet.sh

[robi]

Here's an example of my zeronet.conf & nginx.conf trying to get it working for a few days now ;-/

I get 404s in the log/debug.log for / and the Websocket requests which breaks the page from loading with the message: UiServer Websocket was lost. Reconnecting.. immediately after it connects ;-/

https://paste.cloudron.io/dayaqeciho.properties

Not sure what's breaking it from the proxy perspective, as it works from a localhost install.

Additional hints from the original, now outdated version, https://zeronet.io/docs/faq/

[girish]

sorry, I am not installing crypt stuff

[robi]

@girish sorry? You're mistaken, it's not crypto/chain/coins stuff at all. Just python.

It only looks like it since it uses a library that makes those long addresses unique. That's it.

[girish]

@robi ah! I completely misread what this project is. I saw Bitcoin in the title and tuned out

[LoudLemur]

@girish said in ZeroNet:

sorry, I am not installing crypt stuff

Just curious why you don't like crypto...

[girish]

@LoudLemur nothing to dislike (or like), mostly I don't have much idea about it

[necrevistonnezr]

@LoudLemur said in ZeroNet:

@girish said in ZeroNet:

sorry, I am not installing crypt stuff

Just curious why you don't like crypto...

I personally don’t „like“ crypto because the bad far outweighs any good coming from it: It is the catalyst for the shitshow of cybercrime we find ourselves in today, where little assholes in Russia or Iran cripple and extort hospitals. It keeps North Korea alive. It fuels the Mafia. It enables scams. And that’s just the tip of the iceberg. It’s just a general bad idea to deprive states and state unions from control over the money system.

[robi]

Works great from a desktop, eazy peasy.

However, after a week of trying all combinations, I am exhausted.
I still can't get the ZeroNet page to display all assets, just looks blank and loses its websocket connection, how infuriating!

Here's the two location directives I've tried for nginx.conf:

    location / {
        proxy_pass http://172.18.16.63:43110;
        proxy_set_header Host $host;
        proxy_http_version 1.1;
        proxy_read_timeout 1h; # for long live websocket connetion
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_cache_bypass $http_upgrade;

        proxy_set_header X-Request-Start "t=${msec}";
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto "https";

        add_header X-Frame-Options "SAMEORIGIN";
        add_header X-XSS-Protection "1; mode=block";
        add_header X-Content-Type-Options "nosniff";

        if ($http_user_agent ~ CloudronHealth ) { 
                return 200;          #Healthcheck fix
        }
        proxy_redirect off;
    }

    location /ZeroNet-Internal/Websocket {
#        proxy_pass http://websocket;
        proxy_pass http://172.18.16.63:15441;
#        proxy_set_header Host $host;
        proxy_http_version 1.1;
        proxy_read_timeout 1h; #for long live websocket connetion
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_cache_bypass $http_upgrade;

        proxy_set_header X-Request-Start "t=${msec}";
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto "https";
        proxy_redirect off;
    }

I also tried running it from a Surfer app instead of LAMP app, same result. (But they are not websocket apps)

Here's a sample zeronet.conf

[global]
ui_host = zeronet.1heal.org
#fileserver_ip = 172.18.16.63
fileserver_port = 15441
ui_ip = *
# ui_port = 43110
tor = enable
tor_proxy = localhost:9050
tor_controller = localhost:9051

I hope one of you can figure out what is going wrong!

[robi]

A big thanks to @Kubernetes for the collaboration and assistance during his busy day!

The testing package is available here: https://git.cloudron.io/kubernetes/cloudron-zeronet

@staff @AppDev please take a look at how to solve the websocket issue and tor finding its linked libraries that are in the same directory.

tor starts successfully when the LD_LIBRARY_PATH is set to its location.

If you'd like to know more about how it works, see the FAQ page -> https://zeronet.io/docs/faq/

[LoudLemur]

Well done on advancing zeronet so far!
I just thought I would mention this other thread here for those who like zeronnet:

Lokinet
https://forum.cloudron.io/topic/5824/lokinet-on-cloudron?_=1707942770501

[Lanhild]

@robi said in ZeroNet:

please take a look at how to solve the websocket issue and tor finding its linked libraries that are in the same directory.

Thanks for the heads up. I don't have enough knowledge about this aspect to help though.

Next time, consider not mentioning staff or app devs groups, as it sends an email to each members by default. I'm sure the people that wish to contribute would regardless of a notification

[robi]

@Lanhild Thanks for the note, didn't know it emailed.

[timconsidine]

I published a custom app for ZeroNet :

https://git.cloudron.io/timconsidine/cloudron-zeronet

not yet published to CCAI master catalogue
Now added to CCAI master catalogue, and public docker image at tcmbp132021/cloudron-zeronet:latest

This is based on Zeronet Conservancy repo as the original Zeronet seems to unmainted.

I confess that I am far from an expert on Zeronet.
The POSTINSTALL in the app dashboard has some links for learning.

[timconsidine]

pushed a new version v1.0.63

Test site : 191CazMVNaAcT9Y1zhkxd9ixMBPs59g2um

tweaked : v1.0.64

[robi]

@timconsidine it's missing an expected directory structure where all sites go to /app/data/data/

The first zite it loads is it's ZeroHello site: something like 1GnACK...../content.json

The TOR ports need opening up.
It can't seem to reach trackers either.
it needs to be able to edit it's own config file for it's own autodetections as well as when adjusting things from the webUI.

Pull down log shows some of what I mentioned:

Displaying 243 of 243 lines found in the last 32kB of the log file. (71kB total)
[2026-02-13 15:24:29,933] WARNING PeerPortchecker checkIpv6scanner check error: URLError: <urlopen error timed out> in PeerPortchecker.py line 49 > 144 > 28 > <urllib>/request.py line 215 > 515 > 532 > 492 > 1373 > 1347 in 20.105s
[2026-02-13 15:24:29,934] INFO ConnServer Server port opened ipv4: False, ipv6: False
[2026-02-13 15:24:29,938] DEBUG ConnServer External ip found on interfaces: fd00:c107:d509::57
[2026-02-13 15:24:29,938] DEBUG TorManager Start onions
[2026-02-13 15:24:29,940] DEBUG TorManager > ADD_ONION NEW:ED25519-V3 port=15441
[2026-02-13 15:24:30,219] DEBUG TorManager < 250-ServiceID=svwuljx6fxdadufrsxgudnvsatf5tepvr3xqien2lettldygoilu5xad
250-PrivateKey=ED25519-V3:0MxDGrbMTtSd4IN8UiuFls8NPmBL4jRJw4erms8xJ1nIUgG/JwLjmOF1YXsd2tHczYeINPo+A/sQbbeR7zZJLw==
250 OK
[2026-02-13 15:24:30,220] DEBUG TorManager Created new hidden service for global: svwuljx6fxdadufrsxgudnvsatf5tepvr3xqien2lettldygoilu5xad
[2026-02-13 15:24:30,220] DEBUG ConnServer Checksites done in 21.818s
[2026-02-13 15:24:30,254] DEBUG Ui.UiServer 172.18.0.1 - - [2026-02-13 15:24:30] "GET / HTTP/1.1" 200 1699 0.000542
[2026-02-13 15:24:31,390] DEBUG Site:1GnACK..PDnF Recent peers 0 of 0 (need: 20)
[2026-02-13 15:24:31,391] DEBUG Site:1GnACK..PDnF Pex result: from 0 peers got 0 new peers.
[2026-02-13 15:24:33,413] DEBUG Site:1GnACK..PDnF Tracker http://tracker.opentrackr.org:1337/announce announce failed: URLError: <urlopen error timed out> in SiteAnnouncer.py line 201 > AnnounceBitTorrentPlugin.py line 129 > 94 > <urllib>/request.py line 215 > 515 > 532 > 492 > 1373 > 1347 in mode start
[2026-02-13 15:24:38,185] DEBUG Ui.UiServer 172.18.0.1 - - [2026-02-13 15:24:38] "GET /191CazMVNaAcT9Y1zhkxd9ixMBPs59g2um/ HTTP/1.1" 200 1699 0.000810
[2026-02-13 15:24:39,360] DEBUG Ui.UiServer 172.18.0.1 - - [2026-02-13 15:24:39] "GET /favicon.ico HTTP/1.1" 200 270651 0.012992
[2026-02-13 15:24:40,503] DEBUG Ui.UiServer 172.18.0.1 - - [2026-02-13 15:24:40] "GET / HTTP/1.1" 200 1699 0.000644
...
[2026-02-13 15:29:09,406] DEBUG Site:1GnACK..PDnF Content.json not exist: ./data/1GnACKctkJrGWHTqxk9T9zXo2bLQc2PDnF/content.json
[2026-02-13 15:29:12,773] DEBUG Site:1GnACK..PDnF Tracker failed, skipping to next one...
[2026-02-13 15:29:14,408] DEBUG Site:1GnACK..PDnF CheckModifications: Waiting for peers...

There's no need to package the separate admin pw, since it's in the config file.

If you do a local install on your computer, you'll see what I mean in terms of dir structure and how it works when you watch the log.
It downloads it's homepage from peers it connects to from trackers who have a list of peers.

More on the ZeroNet Docs website:
https://demo.zeronet.io/docs/

Online proxyies still functioning:
https://0net-preview.com/
https://zero.acelewis.com/

This proxy is really what we're setting up here since it's self-hosted in Cloudron. Here's an example set of instructions to install it as a proxy: https://bondarenko.xyz/zeroproxy.html

[timconsidine]

@robi investigating ....

[timconsidine]

released v1.0.76

• 'data' folder was not missing - just mapped directly to (i.e. included in /app/data) - but changed to /app/data/data - "clumsy" but more conventional for zeronet maybe

• Tor enabled in / out

I dislike the conventional 0net approach of hosting a default standard home page from another site - confusing to new users in my view - so I made my own home page which is clearer (but can be fleshed out or adapted further if needed), with links to the standard sites included for conventionality.

Highly recommend a new install in new container for testing (and live use) as many small changes. 1 line install :

curl -fsSL https://customappgateway.appx.uk/install.sh | bash -s -- --install-app "zeronet"

[robi]

@timconsidine said in ZeroNet:

released v1.0.76

Thank you!

• 'data' folder was not missing - just mapped directly to (i.e. included in /app/data) - but changed to /app/data/data - "clumsy" but more conventional for zeronet maybe

Alright, that data/ dir is the expected place by the code. It has very specific reasons for that structure, just like public_html/ does. Some things do not go in there, like the config file, as it is then writable from the web. But the Geolite DB is expected there, or the right menu breaks (drag the 0 menu left) the world.

• Tor enabled in / out

You set the Tor option to Always, instead of Enabled, so it will funnel ALL requests through tor, not just the Tor connections. This is going to make things very slow.

I dislike the conventional 0net approach of hosting a default standard home page from another site - confusing to new users in my view - so I made my own home page which is clearer (but can be fleshed out or adapted further if needed), with links to the standard sites included for conventionality.

Oh, that totally defeats the purpose as the magic of Zeronet is it's default homepage. It's not static as it keeps track of the sites you visit and let's you know of new posts in forums, blogs, etc. It's the lifeblood of the Zeronet experience. Changing it removes that magic.

Each fork has it's own default page since there are specifics linked to it like new versions of old zites that no longer work or new ID sites, etc. Important to keep it.

One should be able to change and update the UI password as well. Doesn't seem possible at the moment, hardcoded?

The plugins dir is also missing or not linked to /app/data/, which is how features get turned on and off in Zeronet, by renaming of these plugin dirs.

Right now I can't seem to browse to anywhere and it keeps asking for the UI pw for every zite. Missing plugins.

Getting closer to functional!

Please restore the vanilla install experience.