A small Pritunl image that can be used to start a Pritunl server.
1.29.1979.981.29.2232.32,latest
Pritunl is the most secure VPN server available and the only VPN server to offer up to five layers of authentication.
from pritunl.com
There are a couple of things needed for the script to work.
Docker, either the Community Edition (CE) or Enterprise Edition (EE), needs to be installed on your local computer.
Docker installation instructions can be found here.
In order to end up with a functional Pritunl service - after having build the container - some configurations have to be performed.
To help perform those configurations a small set of commands is included on the Docker container.
help- Usage help.init- Configure the Pritunl service.start- Start the Pritunl service.
To store the configuration settings of the Pritunl server as well as the users information a volume should be created and added to the container when running the same.
To be able to make all of the Pritunl data persistent, the same will have to be stored on a different volume.
Creating volumes can be done using the docker tool. To create a volume use
the following command:
docker volume create --name VOLUME_NAME
To create the required volume the following command can be used:
docker volume create --name my_pritunl
Note: A local folder can also be used instead of a volume. Use the path of the folder in place of the volume name.
To configure the Pritunl server the init command must be used.
docker container run --volume PRITUNL_VOL:/data:rw --rm fscm/pritunl [options] init
-m <URI>- [required] The MongoDB URI (e.g.: mongodb:https://mongodb.host:27017/pritunl).
After this step the Pritunl server should be configured and ready to use.
An example on how to configure the Pritunl server:
docker container run --volume my_pritunl:/data:rw --rm fscm/pritunl:latest -m mongodb:https://mongodb:27017/pritunl init
Note: This command will output the SetupKey and the default Administrator credentials. Take note of those for later use on the service web interface.
After configuring the Pritunl server the same can now be started.
Starting the Pritunl server can be done with the start command.
docker container run --volume PRITUNL_VOL:/data:rw --detach --publish 1194:1194/udp --publish 1194:1194 --publish 443:443 --publish 80:80 --privileged --device=/dev/net/tun fscm/pritunl:latest start
The Docker options --privileged and--device=/dev/net/tun are required for
the container to be able to start.
To help managing the container and the Pritunl instance a name can be given to
the container. To do this use the --name <NAME> docker option when starting
the server
An example on how the Pritunl service can be started:
docker container run --volume my_pritunl:/data:rw --detach --publish 1194:1194/udp --publish 1194:1194 --publish 443:443 --publish 80:80 --privileged --device=/dev/net/tun --name my_pritunl fscm/pritunl:latest start
To see the output of the container that was started use the following command:
docker container attach CONTAINER_ID
Use the ctrl+p ctrl+q command sequence to detach from the container.
If needed the Pritunl server can be stoped and later started again (as long as the command used to perform the initial start was as indicated before).
To stop the server use the following command:
docker container stop CONTAINER_ID
To start the server again use the following command:
docker container start CONTAINER_ID
The Pritunl server status can be check by looking at the Pritunl server output data using the docker command:
docker container logs CONTAINER_ID
Build instructions can be found here.
This project uses SemVer for versioning. For the versions available, see the tags on this repository.
- Frederico Martins - fscm
See also the list of contributors who participated in this project.