Skip to content

konamicode9/nntpchan

Repository files navigation

le ebin logo

MIT License Logo is ebin

NNTPChan (previously known as overchan) is a decentralized imageboard that uses the NNTP protocol (network-news transfer protocol) to synchronize content between many different servers. It utilizes cryptographically signed posts to perform optional/opt-in decentralized moderation.

Getting started

This is a step-by-step guide for getting up-and-running with NNTPChan as well as documentation for developers who want to either work on NNTPChan directly or use NNTPChan in their aplications with the API.

Install the dependancies

sudo apt-get update
sudo apt-get --no-install-recommends install imagemagick ffmpeg sox build-essential git ca-certificates postgresql postgresql-client golang

Enable Some Modules

export GO111MODULE=off
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Get the NNTPChan source

git clone https://github.com/konamicode9/nntpchan
cd nntpchan

Now compile!

Run make:

make

now its time to create the database in postgres

CREATE DATABASE nntpchan;
CREATE USER username WITH PASSWORD 'CHANGEME';
GRANT ALL PRIVILEGES ON DATABASE nntpchan TO username;

Running NNTPChan

Once you have built NNTPChan and done the initial setup you you can start NNTPChan.

Before running make sure you run the setup command, you only need to do this one time:

./srndv2 setup

You can now start the NNTPChan node (srndv2) by running:

./srndv2 run

Now you can check out the web-interface by navigating to 127.0.0.1:18000 (default address - unless you have changed it in your srnd.ini) or you can configure your newsreader.

Bugs and issues

PLEASE report any bugs you find while building, setting-up or using NNTPChan on the GitHub issue tracker, the issue tracker on tor, the issue tracker on i2p or on the GitGud issue tracker so that the probelms can be resolved or discussed.

Clients

NNTP (confirmed working):

  • Thunderbird

Web:

  • Yukko: ncurses based nntpchan web ui reader

History

  • started in mid 2013 on anonet

This is a graph of the post flow of the overchan.test newsgroup over 4 years, quite a big network.

(thnx anon who made this btw)

network topology of 4 years

source code for map generation

Acknowledgements

  • Deavmi - Making the documentation beautiful.