https://github.com/jamesclonk/easy-vpn
:bomb: commandline tool to spin up a VPN server on a cloud VPS that self-destructs after reaching a timelimit
https://github.com/jamesclonk/easy-vpn
cloud-vps docker go pptpd vpn-server
Last synced: 3 months ago
JSON representation
:bomb: commandline tool to spin up a VPN server on a cloud VPS that self-destructs after reaching a timelimit
- Host: GitHub
- URL: https://github.com/jamesclonk/easy-vpn
- Owner: JamesClonk
- License: mit
- Created: 2015-01-16T11:22:51.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2015-01-26T10:40:52.000Z (over 10 years ago)
- Last Synced: 2025-03-28T19:38:32.952Z (7 months ago)
- Topics: cloud-vps, docker, go, pptpd, vpn-server
- Language: Go
- Homepage:
- Size: 492 KB
- Stars: 27
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# easy-vpn
a simple commandline tool to spin up a VPN server on a cloud VPS that self-destructs after reaching a max. uptime
--------
## What does it do?
easy-vpn allows you to quickly spin up a new VM on a cloud VPS provider (currently supports DigitalOcean and VULTR)
that contains a running VPN server (pptpd) to use. After reaching a certain max. amount of uptime the VM will
self-destruct (destroy) itself, to stop any ongoing costs on your cloud VPS account.
## How does it do that?
easy-vpn will first add the public-key specified in the configuration file to your cloud VPS providers admin panel.
Then it will create and start a new VM named **easy-vpn** with this public-key installed. After the VM is up and ready
to be used it will connect via SSH to it, install docker and run the docker image
[docker-pptpd](https://github.com/JamesClonk/docker-pptpd). It will create a randomly generated username and password
for pptpd to be used. Also within the VM it will run the shellscript **self-destruct.sh**, which upon reaching a
timelimit will cause the VM to self-destruct / destroy itself, by making an API call to your cloud VPS provider.
### Installation from source
* Requires [Go 1.4+](https://golang.org/)
`go get github.com/JamesClonk/easy-vpn`
### Configuration
`vim easy-vpn.toml`
### Usage
`easy-vpn help`
=============
#### Notes
* This project is NOT, *ABSOLUTELY NOT* intended to provide privacy or security