{"id":21890462,"url":"https://github.com/jamesclonk/easy-vpn","last_synced_at":"2025-07-14T03:42:01.768Z","repository":{"id":25904908,"uuid":"29345599","full_name":"JamesClonk/easy-vpn","owner":"JamesClonk","description":":bomb: commandline tool to spin up a VPN server on a cloud VPS that self-destructs after reaching a timelimit","archived":false,"fork":false,"pushed_at":"2015-01-26T10:40:52.000Z","size":504,"stargazers_count":27,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-28T19:38:32.952Z","etag":null,"topics":["cloud-vps","docker","go","pptpd","vpn-server"],"latest_commit_sha":null,"homepage":"","language":"Go","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/JamesClonk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-16T11:22:51.000Z","updated_at":"2024-11-02T23:35:33.000Z","dependencies_parsed_at":"2022-08-24T14:16:39.683Z","dependency_job_id":null,"html_url":"https://github.com/JamesClonk/easy-vpn","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JamesClonk%2Feasy-vpn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JamesClonk%2Feasy-vpn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JamesClonk%2Feasy-vpn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JamesClonk%2Feasy-vpn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JamesClonk","download_url":"https://codeload.github.com/JamesClonk/easy-vpn/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249062137,"owners_count":21206628,"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":["cloud-vps","docker","go","pptpd","vpn-server"],"created_at":"2024-11-28T11:33:04.058Z","updated_at":"2025-04-15T11:39:03.677Z","avatar_url":"https://github.com/JamesClonk.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# easy-vpn\na simple commandline tool to spin up a VPN server on a cloud VPS that self-destructs after reaching a max. uptime\n\n![Screenshot](https://github.com/JamesClonk/easy-vpn/raw/master/screenshot.png \"Screenshot\")\n\n--------\n\n## What does it do?\n\neasy-vpn allows you to quickly spin up a new VM on a cloud VPS provider (currently supports DigitalOcean and VULTR) \nthat contains a running VPN server (pptpd) to use. After reaching a certain max. amount of uptime the VM will \nself-destruct (destroy) itself, to stop any ongoing costs on your cloud VPS account.\n\n## How does it do that?\n\neasy-vpn will first add the public-key specified in the configuration file to your cloud VPS providers admin panel. \nThen it will create and start a new VM named **easy-vpn** with this public-key installed. After the VM is up and ready \nto be used it will connect via SSH to it, install docker and run the docker image \n[docker-pptpd](https://github.com/JamesClonk/docker-pptpd). It will create a randomly generated username and password \nfor pptpd to be used. Also within the VM it will run the shellscript **self-destruct.sh**, which upon reaching a \ntimelimit will cause the VM to self-destruct / destroy itself, by making an API call to your cloud VPS provider.\n\n### Installation from source\n\n* Requires [Go 1.4+](https://golang.org/)\n\n`go get github.com/JamesClonk/easy-vpn`\n\n### Configuration\n\n`vim easy-vpn.toml`\n\n### Usage\n\n`easy-vpn help`\n\n=============\n\n#### Notes\n* This project is NOT, *ABSOLUTELY NOT* intended to provide privacy or security\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamesclonk%2Feasy-vpn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamesclonk%2Feasy-vpn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamesclonk%2Feasy-vpn/lists"}