Docker image with Pritunl.
This script will create a Docker image with Pritunl installed and with all of the required initialization scripts.
The Docker image resulting from this script should be the one used to instantiate a Pritunl server.
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 create a Docker image using this Dockerfile you need to run the
docker
command with a few options.
docker image build --force-rm --no-cache --quiet --tag <USER>/<IMAGE>:<TAG> <PATH>
<USER>
- [required] The user that will own the container image (e.g.: "johndoe").<IMAGE>
- [required] The container name (e.g.: "pritunl").<TAG>
- [required] The container tag (e.g.: "latest").<PATH>
- [required] The location of the Dockerfile folder.
A build example:
docker image build --force-rm --no-cache --quiet --tag johndoe/my_pritunl:latest .
To clean any image(s) left by the build process the following command can be used:
docker image rm `docker image ls --filter "dangling=true" --quiet`
You can also use the following command to achieve the same result:
docker image prune -f
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 <USER>/<IMAGE>:<TAG> [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 johndoe/my_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/pritunl:rw --detach --publish 1194:1194/udp --publish 1194:1194 --publish 443:443 --publish 80:80 --privileged --device=/dev/net/tun <USER>/<IMAGE>:<TAG> 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/pritunl:rw --detach --publish 1194:1194/udp --publish 1194:1194 --publish 443:443 --publish 80:80 --privileged --device=/dev/net/tun --name my_pritunl johndoe/my_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>
Additional tags can be added to the image using the following command:
docker image tag <image_id> <user>/<image>:<extra_tag>
After adding an image to Docker, that image can be pushed to a Docker registry... Like Docker Hub.
Make sure that you are logged in to the service.
docker login
When logged in, an image can be pushed using the following command:
docker image push <user>/<image>:<tag>
Extra tags can also be pushed.
docker image push <user>/<image>:<extra_tag>
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request
Please read the CONTRIBUTING.md file for more details on how to contribute to this project.
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.
This project is licensed under the MIT License - see the LICENSE file for details