pkdns

DNS server resolving pkarr self-sovereign domains.

Getting Started

Hosted DNS

Use one of the hosted DNS servers to try out pkarr quickly.

• Verify the server is working.
• Configure your system dns.
• Browse the self-sovereign web.

Pre-Built Binaries

1. Download the latest release for your plattform.
2. Extract the tar file. Should be something like tar -xvf tarfile.tar.gz.
3. Run pkdns -f 8.8.8.8.
4. Verify the server is working.
5. Configure your system dns.
6. Browse the self-sovereign web.

Build It Yourself

Make sure you have the Rust toolchain installed.

1. Clone repository git clone https://github.com/SeverinAlexB/pkdns.git.
2. Switch directory cd pkdns.
3. Run cargo run -- -f 8.8.8.8.
4. Verify the server is working.
5. Configure your system dns to 127.0.0.1.
6. Browse the self-sovereign web.

Guides

Change your System DNS

Follow one of the guides to change your DNS server on your system:

• MacOS guide
• Ubuntu guide
• Windows guide

Verify your server with this domain http://7fmjpcuuzf54hw18bsgi3zihzyh4awseeuq5tmojefaezjbd64cy/.

Verify pkdns is working

Verify the server resolves pkarr domains. Replace PKDNS_SERVER_IP with either a hosted server ip or 127.0.0.1 if you run it on your localhost.

nslookup 7fmjpcuuzf54hw18bsgi3zihzyh4awseeuq5tmojefaezjbd64cy PKDNS_SERVER_IP

Troubleshooting If this does not work then the pkdns server is likely not running.

Verify it resolves regular ICANN domains. Replace PKDNS_SERVER_IP with either a hosted server ip or 127.0.0.1 if you run it on your localhost.

nslookup example.com PKDNS_SERVER_IP

Troubleshooting If this does not work then you need to change your ICANN fallback server with pkdns -f REGULAR_DNS_SERVER_IP. Or use the Google DNS server: pkdns -f 8.8.8.8.

Browse the Self-Sovereign Web

Here are some example pkarr domains:

• http://7fmjpcuuzf54hw18bsgi3zihzyh4awseeuq5tmojefaezjbd64cy/.
• http://pknames.p2p.7fmjpcuuzf54hw18bsgi3zihzyh4awseeuq5tmojefaezjbd64cy/.

Options

Usage: pkdns [OPTIONS]

Options:
  -f, --forward <forward>      ICANN fallback DNS server. IP:Port [default: 192.168.1.1:53]
  -s, --socket <socket>        Socket the server should listen on. IP:Port [default: 0.0.0.0:53]
  -v, --verbose                Show verbose output.
      --no-cache               Disable DHT packet caching.
      --threads <threads>      Number of threads to process dns queries. [default: 4]
  -d, --directory <directory>  pknames source directory. [default: ~/.pknames]
  -h, --help                   Print help
  -V, --version                Print version

May the power ⚡ be with you.