From 3588642b4baf37f62105636e830e17a3c9e18ced Mon Sep 17 00:00:00 2001 From: Dan Guido Date: Sun, 3 Aug 2025 04:45:16 -0400 Subject: [PATCH] Clean up README.md donation options and badges (#14783) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Clean up README.md donation options and badges - Remove Flattr and Bountysource donation options from badges and text - Remove Actions workflow status badge - Update Twitter/X link to use x.com domain 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude * Update version requirements for better consistency and accuracy - Update Ubuntu references to 22.04 LTS or later throughout documentation - Ensure Python version requirement consistently states 3.10 or later - Update macOS references from Catalina (10.15) to Big Sur (11.0) for better accuracy - Update Windows references to include Windows 11 alongside Windows 10 - Update Windows Store Ubuntu link from 20.04 to 22.04 LTS These changes improve user experience by providing current and consistent version requirements across all documentation. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude * refine: Simplify README version references - Feature list: Windows 11 only (cleaner than 10/11) - Remove specific Ubuntu version from feature list - Remove 'or later' from Python requirements (just Python 3.10) - Keep Linux installation section generic without version numbers --------- Co-authored-by: Claude --- README.md | 15 ++++++--------- docs/deploy-from-windows.md | 4 ++-- 2 files changed, 8 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 397e75b..2bcf2d0 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,13 @@ # Algo VPN -[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/fold_left.svg?style=social&label=Follow%20%40AlgoVPN)](https://twitter.com/AlgoVPN) -[![](https://github.com/trailofbits/algo/workflows/Main/badge.svg?branch=master)](https://github.com/trailofbits/algo/actions) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/fold_left.svg?style=social&label=Follow%20%40AlgoVPN)](https://x.com/AlgoVPN) Algo VPN is a set of Ansible scripts that simplify the setup of a personal WireGuard and IPsec VPN. It uses the most secure defaults available and works with common cloud providers. See our [release announcement](https://blog.trailofbits.com/2016/12/12/meet-algo-the-vpn-that-works/) for more information. ## Features * Supports only IKEv2 with strong crypto (AES-GCM, SHA2, and P-256) for iOS, macOS, and Linux -* Supports [WireGuard](https://www.wireguard.com/) for all of the above, in addition to Android and Windows 10 +* Supports [WireGuard](https://www.wireguard.com/) for all of the above, in addition to Android and Windows 11 * Generates .conf files and QR codes for iOS, macOS, Android, and Windows WireGuard clients * Generates Apple profiles to auto-configure iOS and macOS devices for IPsec - no client software required * Includes a helper script to add and remove users @@ -40,9 +39,9 @@ The easiest way to get an Algo server running is to run it on your local system git clone https://github.com/trailofbits/algo.git ``` -3. **Install Algo's core dependencies.** Algo requires that **Python 3.10 or later** and at least one supporting package are installed on your system. +3. **Install Algo's core dependencies.** Algo requires that **Python 3.10** and at least one supporting package are installed on your system. - - **macOS:** Catalina (10.15) and higher includes Python 3 as part of the optional Command Line Developer Tools package. From Terminal run: + - **macOS:** Big Sur (11.0) and higher includes Python 3 as part of the optional Command Line Developer Tools package. From Terminal run: ```bash python3 -m pip install --user --upgrade virtualenv @@ -50,7 +49,7 @@ The easiest way to get an Algo server running is to run it on your local system If prompted, install the Command Line Developer Tools and re-run the above command. - For macOS versions prior to Catalina, see [Deploy from macOS](docs/deploy-from-macos.md) for information on installing Python 3 . + For macOS versions prior to Big Sur, see [Deploy from macOS](docs/deploy-from-macos.md) for information on installing Python 3 . - **Linux:** Recent releases of Ubuntu, Debian, and Fedora come with Python 3 already installed. If your Python version is not 3.10, then you will need to use pyenv to install Python 3.10. Make sure your system is up-to-date and install the supporting package(s): * Ubuntu and Debian: @@ -252,14 +251,12 @@ If you've read all the documentation and have further questions, [create a new d -- [Thorin Klosowski](https://twitter.com/kingthor) for [Lifehacker](http://lifehacker.com/how-to-set-up-your-own-completely-free-vpn-in-the-cloud-1794302432) ## Support Algo VPN -[![Flattr](https://button.flattr.com/flattr-badge-large.png)](https://flattr.com/submit/auto?fid=kxw60j&url=https%3A%2F%2Fgithub.com%2Ftrailofbits%2Falgo) [![PayPal](https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=CYZZD39GXUJ3E) [![Patreon](https://img.shields.io/badge/back_on-patreon-red.svg)](https://www.patreon.com/algovpn) -[![Bountysource](https://img.shields.io/bountysource/team/trailofbits/activity.svg)](https://www.bountysource.com/teams/trailofbits) All donations support continued development. Thanks! -* We accept donations via [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=CYZZD39GXUJ3E), [Patreon](https://www.patreon.com/algovpn), and [Flattr](https://flattr.com/submit/auto?fid=kxw60j&url=https%3A%2F%2Fgithub.com%2Ftrailofbits%2Falgo). +* We accept donations via [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=CYZZD39GXUJ3E) and [Patreon](https://www.patreon.com/algovpn). * Use our [referral code](https://m.do.co/c/4d7f4ff9cfe4) when you sign up to Digital Ocean for a $10 credit. * We also accept and appreciate contributions of new code and bugfixes via Github Pull Requests. diff --git a/docs/deploy-from-windows.md b/docs/deploy-from-windows.md index a9d942c..e15044f 100644 --- a/docs/deploy-from-windows.md +++ b/docs/deploy-from-windows.md @@ -5,7 +5,7 @@ The Algo scripts can't be run directly on Windows, but you can use the Windows S To run WSL you will need: * A 64-bit system -* 64-bit Windows 10 (Anniversary update or later version) +* 64-bit Windows 10/11 (Anniversary update or later version) ## Install WSL @@ -21,7 +21,7 @@ Wait a minute for Windows to install a few things in the background (it will eve 2. Click on 'Turn Windows features on or off' 3. Scroll down and check 'Windows Subsystem for Linux', and then click OK. 4. The subsystem will be installed, then Windows will require a restart. -5. Restart Windows and then install [Ubuntu 20.04 LTS from the Windows Store](https://www.microsoft.com/p/ubuntu-2004-lts/9n6svws3rx71). +5. Restart Windows and then install [Ubuntu 22.04 LTS from the Windows Store](https://www.microsoft.com/store/productId/9PN20MSR04DW). 6. Run Ubuntu from the Start menu. It will take a few minutes to install. It will have you create a separate user account for the Linux subsystem. Once that's done, you will finally have Ubuntu running somewhat integrated with Windows. ## Install Algo