Skip to content
This repository has been archived by the owner on May 23, 2021. It is now read-only.

WeeJeWel/pivpn-web

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

59 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—‘ THIS PROJECT IS DEPRECATED πŸ—‘

Please uninstall PiVPN and upgrade to WireGuard Easy. It's much simpler and better! πŸŽ‰


PiVPN Web

Build & Publish Docker Image to Docker Hub Docker Docker Sponsor

PiVPN Web is an open-source Web UI for PiVPN (when using WireGuard).

Features

  • A beautiful & easy to use UI
  • Easy installation: just one command
  • List, create, delete, enable & disable users
  • Show a user's QR code
  • Download a user's configuration file
  • See which users are connected
  • Log in with your Linux username & password
  • Connects to your local PiVPN installation β€” or remote over SSH
  • Gravatar support 😏

Requirements

  • Docker installed
  • PiVPN installed (WireGuard, not OpenVPN)
  • SSH enabled

Installation

1. Install Docker

# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Add user 'pi' to group 'docker'
sudo usermod -aG docker pi

2. Install PiVPN

curl -L https://install.pivpn.io | bash

See https://pivpn.io for detailed instructions.

3. Install PiVPN Web

Run this command once to automatically start the service on boot.

docker run -d -p 51821:51821 --name pivpn-web --restart=unless-stopped weejewel/pivpn-web

πŸ’‘ Remove the restart=always flag to prevent auto-start on boot.

πŸ’‘ You can set the environment variable SSH_HOST to a hostname/IP to connect to a different PiVPN server than PiVPN Web is running on.

πŸ’‘ There's also a docker-compose.yml file.

Usage

Open http://<ip-of-your-pi>:51821 and log in with your Raspberry Pi username & password.

πŸ’‘ The default Raspbian username is pi and the default password is raspberry.

πŸ’‘ When a client's name is a valid Gravatar e-mail, they will be shown with their avatar.

Supported environment variables

Variable Default Comment
PORT 51821 The listening port (number)
SSH_HOST 172.17.0.1 The SSH host to connect to (ip)
SSH_PORT 22 The SSH port to connect to (number)
ENABLE_2FA no Enable 2FA login support (yes/no)

Updating

Run these commands to update to the latest version.

docker stop pivpn-web
docker rm pivpn-web
docker pull weejewel/pivpn-web
docker run -d -p 51821:51821 --name pivpn-web --restart=unless-stopped weejewel/pivpn-web