{"id":13542689,"url":"https://github.com/pivpn/pivpn","last_synced_at":"2025-05-12T13:23:13.451Z","repository":{"id":37548680,"uuid":"56450375","full_name":"pivpn/pivpn","owner":"pivpn","description":"The Simplest VPN installer, designed for Raspberry Pi","archived":false,"fork":false,"pushed_at":"2025-03-12T07:40:03.000Z","size":2135,"stargazers_count":7531,"open_issues_count":11,"forks_count":663,"subscribers_count":132,"default_branch":"master","last_synced_at":"2025-04-23T16:06:17.544Z","etag":null,"topics":["openvpn","openvpn-installer","pivpn","raspberry-pi","vpn-server","wireguard"],"latest_commit_sha":null,"homepage":"https://pivpn.io","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pivpn.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-04-17T17:53:53.000Z","updated_at":"2025-04-23T15:59:36.000Z","dependencies_parsed_at":"2023-01-30T15:30:42.527Z","dependency_job_id":"f8d0df51-19cc-4eed-87ff-ecd3d0952c5c","html_url":"https://github.com/pivpn/pivpn","commit_stats":{"total_commits":772,"total_committers":104,"mean_commits":7.423076923076923,"dds":0.7590673575129534,"last_synced_commit":"4e4d608b35255680eb1545bfb5555c5b74411b31"},"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivpn%2Fpivpn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivpn%2Fpivpn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivpn%2Fpivpn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivpn%2Fpivpn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pivpn","download_url":"https://codeload.github.com/pivpn/pivpn/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253745377,"owners_count":21957358,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["openvpn","openvpn-installer","pivpn","raspberry-pi","vpn-server","wireguard"],"created_at":"2024-08-01T10:01:15.458Z","updated_at":"2025-05-12T13:23:13.421Z","avatar_url":"https://github.com/pivpn.png","language":"Shell","funding_links":[],"categories":["Shell","raspberry-pi","\u003ca id=\"7cf7e8a30b73997985f20698eaf6b0c9\"\u003e\u003c/a\u003eOpenVPN","Table of Contents","WireGuard \u0026 VPN Tools","Projects"],"sub_categories":["\u003ca id=\"8ea8f890cf767c3801b5e7951fca3570\"\u003e\u003c/a\u003e公网访问局域网","VPN","User Interface"],"readme":"\u003e [!WARNING]\n\u003e PiVPN is maintained on a best-effort basis, please read more about it [here](https://github.com/pivpn/pivpn/releases/tag/v4.6.1). Previous announcement is [here](https://github.com/pivpn/pivpn/releases/tag/v4.6.0).\n\n![Pivpn Banner](pivpnbanner.png)\n\n![Logos](logos.jpg)\n\n**[PIVPN.IO](https://pivpn.io)** | **[DOCUMENTATION](https://docs.pivpn.io)**\n\n\n[![Website shields.io](https://img.shields.io/website-up-down-green-red/https/pivpn.io.svg)](https://pivpn.io/)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/pivpn/pivpn/graphs/commit-activity)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/452112df3c2c435d93aacc113f546eae)](https://app.codacy.com/gh/pivpn/pivpn?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=pivpn/pivpn\u0026utm_campaign=Badge_Grade_Settings)\n[![Build Status](https://travis-ci.com/pivpn/pivpn.svg?branch=master)](https://travis-ci.com/pivpn/pivpn)\n[![Build Status](https://travis-ci.com/pivpn/pivpn.svg?branch=test)](https://travis-ci.com/pivpn/pivpn)\n[![made-with-bash](https://img.shields.io/badge/Made%20with-Bash-1f425f.svg)](https://www.gnu.org/software/bash/)\n[![Generic badge](https://img.shields.io/badge/status-page-blue.svg)](https://stats.uptimerobot.com/8X64yTjrJO)\n[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)\n\nPiVPN is a set of shell scripts developed to easily turn your Raspberry Pi (TM) into a VPN server using two free, open-source protocols:\n* [WireGuard](https://www.wireguard.com/)\n* [OpenVPN](https://openvpn.net)\n\nThis script's primary mission in life is to allow a user to have as cost-effective as possible VPN at home without being a technical wizard, hence the design of PiVPN to work on a Raspberry Pi ($35) with a one-command installer followed by easy management of the VPN with the 'pivpn' command.  \n\nThat being said...\n\nPiVPN should be, bar none, the simplest and fastest way to Install and set up an extremely secure **OpenVPN** or **WireGuard** server on your Raspberry Pi. You won't need a guide or tutorial as PiVPN will do it all for you in a fraction of the time with hardened security settings in place by default.  \n\nWe recommend running PiVPN on the latest RaspberryPi OS Lite image in a Raspberry Pi at your home so you can VPN into your network from not secure remote locations and safely use the internet. However, you can also use PiVPN in any Cloud Provider VPS running Ubuntu or Debian to assist those with untrustworthy ISPs. Running a VPN on a server elsewhere means you can connect to the VPN from home, and because your traffic will be getting out from the cloud/VPS provider, your ISP will only see encrypted traffic. \n\nPiVPN should also work with most Ubuntu and Debian based distributions, including those using UFW by default instead of raw iptables.\t\n\n----\n## Installation\n\n### Method 1 (standard)\n\n```Shell\ncurl -L https://install.pivpn.io | bash\n```\n\n### Method 2 (direct link)\n\n```Shell\ncurl https://raw.githubusercontent.com/pivpn/pivpn/master/auto_install/install.sh | bash\n```\n\n### Method 3 (clone repo)\n\n```Shell\ngit clone https://github.com/pivpn/pivpn.git\nbash pivpn/auto_install/install.sh\n```\n\n### To install from Test/Development branch\n\n```shell\ncurl -L https://test.pivpn.io | TESTING= bash\n```\n\n### To install from custom git url and branch (for DEV)\n\nThis is inteded to be used when testing changes during\ndevelopment and **not** for standard installations.\nWithout this the script will always checkout the master branch.\n\n- Git repo can be pivpn or any other git repo (e.g. a fork).\n- Git branch can be specified as required\n\n```shell\n# Syntax\ngit clone \u003c customgitrepourl \u003e\nbash pivpn/auto_install/install.sh --giturl \u003c customgitrepourl \u003e --gitbranch \u003c customgitbranch \u003e\n\n# Example\ngit clone https://github.com/userthatforked/pivpn.git\nbash pivpn/auto_install/install.sh --giturl https://github.com/userthatforked/pivpn.git --gitbranch myfeaturebranch\n```\n\nThe unattended setup config also supports a custom giturl and branch.\n\n```shell\npivpnGitUrl=\"https://github.com/userthatforked/pivpn.git\"\npivpnGitBranch=\"myfeaturebranch\"\n```\n----\n## Feedback \u0026 Support\n\nPiVPN is purely community-driven and its our objective for PiVPN to work for as many people as possible. We welcome any feedback on your experience.\nPlease be respectful and be aware PiVPN is maintained with volunteers free time!\n\n### General Guidelines\n\n* This project adheres to the Contributor Covenant [code of conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to any project maintainer.\n* You can find our documentation at https://docs.pivpn.io\n* Please read the pinned posts on [Github Discussions](https://github.com/pivpn/pivpn/discussions)\n* Please search for similar [issues](https://github.com/pivpn/pivpn/issues?q=), you can search and apply filters that better match the problems you are facing. \n* Plase search for similar [Discussions](https://github.com/pivpn/pivpn/discussions)\n* If you have not found the answer feel free to open an [issue](https://github.com/pivpn/pivpn/issues/new/choose) and we will do our best to help out\n  * Please help us helping you and fill the template adequately providing the requested data **Even if it doesn't feel relevant to you**\n* PiVPN team may close any Discussion/Issue without any warning if they don't follow the Guidelines\n\n### Contact\n\nOur prefered contact method is through [Github Discussions page](https://github.com/pivpn/pivpn/discussions)\n\nBut the you can also reach out at: \n\n* \\#pivpn at [libera.chat](https://libera.chat) IRC network\n* \\#pivpn:matrix.org at [matrix.org](https://matrix.org)\n* Reddit at [r/pivpn](https://www.reddit.com/r/pivpn/)\n\n### Feature requests\n\nFeature requests are very welcome, please do so at:\n\n* [Feature requests](https://github.com/pivpn/pivpn/discussions/categories/feature-requests)\n\n### Bug reports\n\n* **Make sure the bug is not already reported** by searching on GitHub under [Issues](https://github.com/pivpn/pivpn/issues).\n* If you could not find an open issue addressing the problem, [open a new one](https://github.com/pivpn/pivpn/issues/new/choose). \n  * Please provide all the data requested on the template **Even if it doesn't feel relevant to you** and, if possible, a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.\n\n\n### Pull Requests\n\n* Open a new GitHub pull request towards the [test](https://github.com/pivpn/pivpn/tree/test) branch.\n* Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.\n* Use the following [commit rules](https://github.com/angular/angular/blob/main/CONTRIBUTING.md#-commit-message-format).\n* Use the following [code style rules](https://google.github.io/styleguide/shellguide.html). \n  * We suggest you to use the following [shfmt](https://github.com/mvdan/sh) command: `shfmt -i 2 -ci -sr -w -bn`\n\n## Contributions\n\nPiVPN is not taking donations but if you want to show your appreciation, then contribute or leave feedback on suggestions or improvements.\n\nContributions can come in all kinds of different ways! You don't need to be a developer to help out. \n\n* Please check the current [issues](https://github.com/pivpn/pivpn/issues) and [discussions](https://github.com/pivpn/pivpn/discussions). Maybe there is something you can help with\n* [Documentation](https://github.com/pivpn/docs)! Documentation is never good enough! There is always something missing, or typos, or better English!\n* Our [website](https://pivpn.io) is also Open Source. feel free to suggest any changes or improvements [here](https://github.com/pivpn/pivpn.io)\n* Testing!!! Run pivpn in different ways, different systems, different configurations! Let us know if you find something!\n* Assisting other users in any of our official channels is also very welcomed\n\nStill, if you consider PiVPN useful and want to Donate instead, then consider donating to:\n\n1. [PiVPN Contributors](https://github.com/pivpn/pivpn/graphs/contributors)\n2. [OpenVPNSetup](https://github.com/StarshipEngineer/OpenVPN-Setup)\n3. [pi-hole.net](https://github.com/pi-hole/pi-hole)\n4. [OpenVPN](https://openvpn.net)\n5. [WireGuard](https://www.wireguard.com/)\n6. [EFF](https://www.eff.org/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpivpn%2Fpivpn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpivpn%2Fpivpn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpivpn%2Fpivpn/lists"}