Contribute to Kusama Shield

No matter if you are technical or not, you can help us spread awareness of Kusama Shield and Privacy!

For relatively fast support, email: kusamashield@segfault.net

Can I contribute to Kusama Shield Anonymously?

Yes! We are using codeberg for exactly this reason. Anyone can use the tor browser, sign up fast and contribute to Kusama Shield at codeberg.org/kusamashield.

Host an instance

If you have experience hosting or/and as a system administrator, we encourage you to host a public instance of Kusama Shield. Let us know and we will share it and link it here on the wiki.

Dealing with Abuse complaints

Pattern trolls, legal staff and automated systems may, like any other website, send you takedown and/or abuse requests. If you recieve an email like the above, you are adviced to reply(IDEALLY NOT FROM YOUR PERSON ACCOUNT BUT FROM A GENERIC ONE, so its better pratice to reply from a legal@mydomain rather than nameofperson@domain) with a link to the Terms of Service. Which can be found at the end of all pages in the Kusama Shield UI. As a hosting provider you do not handle custody over any assets and all you are hosting is a way to interact with a decentralized system, do not let pattern trolls scare you into taking the site down.

Host as a tor hidden service:

Spinning up a .onion address for your instance is a fast way to add an extra layer of privacy.

Note: This torrc file will change depending on your operating system.
when running the application as a tor hidden service, its important that you bind only the local interface, so when starting the app run npm run local not npm run dev

/etc/tor/torrc

We will tell tor to listen on port 80 and forward all requests to our local instance:

HiddenServiceDir /var/lib/tor/shield/
HiddenServicePort 80 127.0.0.1:5173

Restart tor and you will find the domain in the /var/lib/tor/shield/hostname file:

cat /var/lib/tor/other_hidden_service/hostname 
aj4giwh2mu2n77f2ji22pqp7lbk2qmz2uhcafnz5oefnwbwfb22zniyd.onion

Grab the domain and try it either with adding .to and pasting it in your browser or by using torsocks and curl:

torsocks curl -v aj4giwh2mu2n77f2ji22pqp7lbk2qmz2uhcafnz5oefnwbwfb22zniyd.onion

Can you connect? if everything is good you can share your .onion publicly!

If you are renting a VPS and only want to host a tor instance, we recommend that you scan your VPS IP with nmap to make sure nothing extra is running on any port:

nmap -sC -sV -p- SERVERIPGOESHERE

If you see a strange port open, on linux you can login and check which process is listening: 

lsof -i | grep THEPORTNUMBERGOESHERE

Help out with documentation

Fix spelling mistakes, improve our documentation. Help more people understand Kusama Shield by translating documentation.

testing the software and reporting bugs

Spread the word about Kusama Shield

Talk about Kusama Shield, spread the word, advocate for privacy

Guerilla Marketing

Promote Kusama Shield by:

  • Writing articles/blog posts
  • Showing demo's
  • Spreading the word
  • Creating designs/images/videos/meme's


Previous we have printed out holographic stickers, this is fun and low cost option to spread awareness of Privacy and Kusama Shield. You can find the designs for the stickers here:
codeberg.org/KusamaShield/Graphics