Skip to content

Latest commit

 

History

History
63 lines (48 loc) · 3.43 KB

README.md

File metadata and controls

63 lines (48 loc) · 3.43 KB
Raw

I2P-Qubes-Templates

All-in-one scripts for easily installing I2P with a dedicated browser for Qubes templates. Also includes the creation of some config files that would generate every time you build a new I2P template, hopefully avoiding having to configure each parameter manually with each new VM.

Installing

  • clone the scripts in an appvm, make them executable, and copy the script to your template

In the AppVM

In your Template

  • $ sudo mv /home/user/QubesIncoming/BLANK/I2P-Debian.sh ~/
    • move the script that you copied over to your /home/user directory. (where BLANK is the appvm your script copied from)
  • $ sudo su
    • become root
  • # bash I2P-Debian.sh

OR

  • $ sudo su
  • # bash /home/user/QubesIncoming/BLANK/I2P-Debian.sh
    • run the script from /home/user as ROOT (where BLANK is the name of appvm you copied from

Run as ROOT

  • verify you are ROOT in the first question
  • select which template you are running the script in
  • You need to be root so you can create the config files and execute scripts within this script. If you want to avoid running this in ROOT then read the script and modify the directory permissions required in your template and try it out. No gurantee it will work though.

Objective

My main goal is to help those who are maybe new to either Qubes or I2P. I have spent quite a few hours of my life answering questions and creating writeups on anonymous forums concering this work, especially for the die-hard Tor users seem to struggle with I2P and Qubes (linux in general, really). So I figured I would try to develop THE repository for all your I2P needs!

Approach

A popular criticism I have seen is that there is no "one-size-fits-all" solution for I2P. Tor users are used to having a ready to go browser bundle to use for their privacy needs. They have gotten used to sticking a simple USB drive with Tails installed into their laptop and it work perfectly, every time. I2P requires a little bit more know-how, which can be troublesome if you are not Linux-saavy. That is the approach that inspired me to write these simple bash scripts. The scripts are designed to do every bit of the "heavy lifting" that make you nervous about installing I2P yourself.

Once Ran, these scripts will:

  • Add the correct repositories needed
  • Import the pgp keys needed for verificaiton
  • Install I2P-Java and Librewolf (a hardened firefox)
  • Configure your I2P router and Librewolf browser together so you have a dedicated browser for I2P

One script to rule them all

This script utilizes basic 'if-then' bash statements, allowing you to run this same script in either Debian/Ubuntu templates or Whonix WS templates. Just follow the prompted questions to select which template the script is running in.

(PS, the Debian prompt works for both Debian-11 and Ubuntu Jammy specifically. This should work universally though as Ubuntu is Debian based).

Qubes specifically, for now

These are written specifically for Qubes templates, so they will not translate perfectly to an average VM or baremetal install of the equivalent distro. Changing the script just a tad for your specific install shouldn't be too hard, but if you are struggling, I will be adding a variant for the Linux users who don't virtualize.