### Install MkDocs Material and Serve Documentation Locally Source: https://context7.com/anon-planet/thgtoa/llms.txt Installs the necessary MkDocs Material package and starts a local development server to preview the documentation. Access the preview at http://127.0.0.1:8000. ```bash pip install mkdocs-material ``` ```bash mkdocs serve ``` -------------------------------- ### Install AnBox using Snap Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Install AnBox in developer mode using snap. This command installs the beta version of AnBox. ```bash snap install --devmode --beta anbox ``` -------------------------------- ### Install AnBox Modules Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Execute the installation script for AnBox modules after cloning the repository. Reboot is required after this step. ```bash ./INSTALL.sh ``` -------------------------------- ### Install OpenVPN on Debian/Ubuntu Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Installs the OpenVPN package on Debian-based systems. Ensure you have internet connectivity before running. ```bash sudo apt-get install openvpn ``` -------------------------------- ### Install ZecWallet Lite on Ubuntu Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Use this command to install the ZecWallet Lite DEB package on Ubuntu 20.04/21.04/21.10. Ensure you are in the download directory. ```bash sudo apt install ./Zecwallet_Lite_1.7.5_amd64.deb ``` -------------------------------- ### MkDocs Configuration File Example Source: https://context7.com/anon-planet/thgtoa/llms.txt An example of the MkDocs configuration file (`mkdocs.yml`) which defines site structure, theme settings, and navigation for the documentation. ```yaml site_name: The Hitchhiker's Guide to Online Anonymity nav: - Home: index.md - Network Privacy: network/ - Device Tracking: device/ - Operational Security: opsec/ theme: name: material plugins: - search ``` -------------------------------- ### Build Guide PDF Locally Source: https://github.com/anon-planet/thgtoa/blob/main/docs/mirrors/index.md To produce the PDF guide locally, clone the repository and execute this Python script. Requires Python, MkDocs Material, and a compatible browser. ```python python3 scripts/build_guide_pdf.py --both ``` -------------------------------- ### Build PDF Workflow Source: https://github.com/anon-planet/thgtoa/blob/main/docs/changelog/index.md GitHub Actions workflow to build the MkDocs site and render the guide to a PDF. It installs Chromium, runs a Python script for PDF generation, and uploads the PDF as an artifact. This workflow is triggered on specific pushes, pull requests, and manual dispatches. ```yaml .github/workflows/build-pdf.yml: install Chromium on ubuntu-latest run scripts/build_guide_pdf.py upload export/guide.pdf as the guide-pdf artifact run on workflow_dispatch, on pushes to main that touch docs or build inputs, and on matching pull requests ``` -------------------------------- ### Install Snapd on Debian Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Install the snapd package manager on your Debian-based Qubes OS VM. This is a prerequisite for installing AnBox via snap. ```bash sudo apt install snapd ``` -------------------------------- ### Start AnBox Emulator Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Launch the AnBox application manager to start the Android emulator. This may need to be run twice if it crashes initially. ```bash anbox.appmgr ``` -------------------------------- ### Configure OpenVPN Autostart Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Enables OpenVPN to automatically start on boot by modifying the default configuration file. Remove the '#' to uncomment the AUTOSTART setting. ```bash sudo nano /etc/default/openvpn ``` ```bash #AUTOSTART="all" ``` ```bash AUTOSTART="all" ``` -------------------------------- ### Install Android App using ADB Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Install an Android application (APK file) onto the AnBox emulator using ADB. Ensure AnBox is running first. ```bash adb install my-app.apk ``` -------------------------------- ### Update Debian System Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Run this command after installing the base system to ensure all packages are up-to-date. This is a standard practice for any new Debian installation. ```bash apt upgrade ``` -------------------------------- ### Build Guide PDF Script Source: https://github.com/anon-planet/thgtoa/blob/main/docs/changelog/index.md Python script to build an MkDocs site and render the guide to a single PDF. It uses a Chromium-based browser in headless mode for printing. When the CI environment variable is set, it passes specific flags to Chromium for compatibility with CI environments. ```python scripts/build_guide_pdf.py: build the MkDocs site and render the guide to a single PDF (export/guide.pdf by default) using a Chromium-based browser (Chrome or Edge) headless print-to-PDF. when the CI environment variable is set, pass Chromium flags (--no-sandbox, --disable-setuid-sandbox, --disable-dev-shm-usage) so headless print works on typical CI images. updated to use --print-to-pdf instead of --save-as for PDF generation. added a new --dark-mode flag to generate dark mode PDFs. ``` -------------------------------- ### Install ZecWallet Lite on Debian 11 Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md These commands install the ZecWallet Lite application and its dependencies on a Debian 11 system. Ensure you are in a secure environment like a VM behind a Whonix Gateway before proceeding. ```bash sudo dpkg -i ./libindicator3-7_0.5.0-4_amd64.deb ``` ```bash sudo dpkg -i ./libappindicator3-1_0.4.92-7_amd64.deb ``` ```bash sudo dpkg -i ./Zecwallet_Lite_1.7.5_amd64.deb ``` -------------------------------- ### Install mat2-web Dependencies Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Installs all required packages for mat2-web, including media processing tools, web server components, and development tools. Ensure your system has internet access to download these packages. ```bash apt install ffmpeg uwsgi python3-pip uwsgi-plugin-python3 lib35rsvg2-dev git mat2 apache2 libapache2-mod-proxy-uwsgi ``` -------------------------------- ### Install Brave Browser on Fedora Disposable VM Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Commands to add the Brave browser repository and install the browser on a Fedora-based Qubes OS VM. Ensure the VM's network is correctly configured before running these commands. ```bash sudo dnf install dnf-plugins-core ``` ```bash sudo dnf config-manager --add-repo https://brave-browser-rpm-release.s3.brave.com/x86_64/ ``` ```bash sudo rpm --import https://brave-browser-rpm-release.s3.brave.com/brave-core.asc ``` ```bash sudo dnf install brave-browser ``` -------------------------------- ### Install GPG on Debian/Ubuntu Source: https://github.com/anon-planet/thgtoa/blob/main/docs/verify/index.md Install the GnuPG (GPG) package on Debian or Ubuntu systems using the apt package manager. This is a prerequisite for using GPG commands. ```bash sudo apt install gnupg ``` -------------------------------- ### Install ADB on Debian Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Install the Android Debug Bridge (ADB) tools on your Debian VM. This is necessary for sideloading Android applications. ```bash sudo apt install android-tools-adb ``` -------------------------------- ### Import GPG Keys Source: https://github.com/anon-planet/thgtoa/blob/main/pgp/core-devs/README.md Use this command to import all GPG keys from the specified directory. Ensure the path to your keys is correct. ```bash $ gpg --import pgp/core-devs/* ``` -------------------------------- ### Upgrade pip Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Upgrades the pip package installer to the latest version. It's good practice to have the latest pip for installing Python packages. ```bash python3 -m pip install pip --upgrade ``` -------------------------------- ### Install GPG on macOS Source: https://github.com/anon-planet/thgtoa/blob/main/docs/verify/index.md Install the GnuPG (GPG) package on macOS using the Homebrew package manager. This is a prerequisite for using GPG commands. ```bash brew install gnupg ``` -------------------------------- ### Install DHCP Client on Whonix Gateway Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Installs the dhcpcd5 package on the Whonix Gateway VM. This is a prerequisite for configuring the VM to obtain an IP address from the network. ```bash sudo apt install dhcpcd5 ``` -------------------------------- ### Import GPG Key Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Import a trusted GPG key into your keyring. Replace 'keyfile.asc' with the actual filename of the key. ```bash gpg --import keyfile.asc ``` -------------------------------- ### View File System Attributes Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Use these commands to view file system attributes, such as download origin and quarantine references, on downloaded files. ```bash mdls filename ``` ```bash xattr -l filename ``` -------------------------------- ### Install Python Modules for mat2-web Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md Installs the necessary Python libraries required by the mat2-web application. These modules provide functionalities for API documentation, configuration parsing, and web framework features. ```bash python3 -m pip install flasgger pyyaml flask-restful flask cerberus flask-cors jinja2 ``` -------------------------------- ### Wipe SSD with `wipe` (2 Passes) Source: https://github.com/anon-planet/thgtoa/blob/main/docs/guide/index.md For SSDs, use `wipe` with the `-qQ2` option for a 2-pass overwrite. Adjust the number after `Q` for more passes. ```bash wipe -qQ2 /dev/sdX ```