Go to file
2021-01-19 10:28:17 +09:00
.circleci Brush up proxy and rss plugin images, build for multiarch support #1483 2020-12-06 21:54:17 +01:00
.github Update stale.yml 2020-12-06 23:15:52 +01:00
docs Add FAQ section on DNS issues, plus minor typing errors and other cleanup #1558 2020-12-06 23:06:46 +01:00
images Improving documentation, not done but getting somewhere #1558 2020-11-26 22:53:37 +01:00
openvpn Fix for #1601. See #1479 for the discovery and current code walkthrough with bug. #1592 will replace this with the official method (they're 90% similar) 2020-12-09 11:57:42 -07:00
plugins/rss Escape special characters in rss-plugin input variables #1565 2020-12-12 00:39:44 +01:00
proxy Brush up proxy and rss plugin images, build for multiarch support #1483 2020-12-06 21:54:17 +01:00
scripts Increase healthcheck ping timeout (#1627) 2021-01-19 10:28:17 +09:00
tinyproxy Fixing startup of tinyproxy on alpine, also add a missing env var to export #1334 2020-10-28 22:37:19 +01:00
transmission Update documentation, add debugging guide #1558 2020-12-05 02:18:16 +01:00
.dockerignore * Add .git to .dockerignore so we don't send to docker build context 2018-02-15 16:05:04 +00:00
docker-compose.yml Merge branch 'dev' into master 2018-01-02 08:46:33 +13:00
Dockerfile Adding git #1489 2020-11-13 01:39:10 +01:00
LICENSE initial commit. working, but needs more features 2014-11-09 16:23:18 +01:00
mkdocs.yml Update documentation, add debugging guide #1558 2020-12-05 02:18:16 +01:00
README.md Missed this #1558 2020-11-27 00:02:29 +01:00

OpenVPN and Transmission with WebUI

CircleCI builds Docker Pulls Join the chat at https://gitter.im/docker-transmission-openvpn/Lobby

This container contains OpenVPN and Transmission with a configuration where Transmission is running only when OpenVPN has an active tunnel. It has built in support for many popular VPN providers to make the setup easier.

Before you continue

The documentation for this image is here:

https://haugene.github.io/docker-transmission-openvpn/

Start there if you're having issues or questions about your container. If you can't find your answer in the docs, please search for similar issues (open and closed) before opening a new one.

Still can't figure it out? Open a new issue and share the details of your setup and some logs. Without that it's hard to help you. If you have a proposal for better documentation, come with it. PR's are always welcome! :)

Quick Start

These examples shows valid setups using PIA as provider for both docker run and docker-compose. Note that you should read some documentation at some point, but this is a good place to start.

Docker run

$ docker run --cap-add=NET_ADMIN -d \
              -v /your/storage/path/:/data \
              -e OPENVPN_PROVIDER=PIA \
              -e OPENVPN_CONFIG=france \
              -e OPENVPN_USERNAME=user \
              -e OPENVPN_PASSWORD=pass \
              -e LOCAL_NETWORK=192.168.0.0/16 \
              --log-driver json-file \
              --log-opt max-size=10m \
              -p 9091:9091 \
              haugene/transmission-openvpn

Docker Compose

version: '3.3'
services:
    transmission-openvpn:
        cap_add:
            - NET_ADMIN
        volumes:
            - '/your/storage/path/:/data'
        environment:
            - OPENVPN_PROVIDER=PIA
            - OPENVPN_CONFIG=france
            - OPENVPN_USERNAME=user
            - OPENVPN_PASSWORD=pass
            - LOCAL_NETWORK=192.168.0.0/16
        logging:
            driver: json-file
            options:
                max-size: 10m
        ports:
            - '9091:9091'
        image: haugene/transmission-openvpn

Please help out (about:maintenance)

This image was created for my own use, but sharing is caring, so it had to be open source. It has now gotten quite popular, and that's great! But keeping it up to date, providing support, fixes and new features takes time. If you feel that you're getting a good tool and want to support it, there are a couple of options:

A small montly amount through Donate with Patreon or a one time donation with Donate with PayPal

All donations are greatly appreciated! Another great way to contribute is of course through code. A big thanks to everyone who has contributed so far!