{"id":20163509,"url":"https://github.com/sjinks/docker-tinc","last_synced_at":"2025-04-10T00:41:08.527Z","repository":{"id":42238997,"uuid":"277674747","full_name":"sjinks/docker-tinc","owner":"sjinks","description":"Tinc VPN 1.1 @ Alpine","archived":false,"fork":false,"pushed_at":"2023-09-08T10:15:19.000Z","size":43,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T02:22:47.323Z","etag":null,"topics":["docker-image","tinc","tinc-pre","vpn"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sjinks.png","metadata":{"funding":{"custom":["https://www.paypal.com/donate/?hosted_button_id=SAG6877JDJ3KU","https://send.monobank.ua/jar/7rosVfiwKM"]},"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-07T00:06:18.000Z","updated_at":"2023-07-30T17:20:23.000Z","dependencies_parsed_at":"2024-11-14T00:40:02.210Z","dependency_job_id":null,"html_url":"https://github.com/sjinks/docker-tinc","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sjinks%2Fdocker-tinc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sjinks%2Fdocker-tinc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sjinks%2Fdocker-tinc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sjinks%2Fdocker-tinc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sjinks","download_url":"https://codeload.github.com/sjinks/docker-tinc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137998,"owners_count":21053775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker-image","tinc","tinc-pre","vpn"],"created_at":"2024-11-14T00:29:54.220Z","updated_at":"2025-04-10T00:41:08.521Z","avatar_url":"https://github.com/sjinks.png","language":"Shell","funding_links":["https://www.paypal.com/donate/?hosted_button_id=SAG6877JDJ3KU","https://send.monobank.ua/jar/7rosVfiwKM"],"categories":[],"sub_categories":[],"readme":"# docker-tinc\n\nTinc VPN 1.1 @ Alpine\n\n## Usage\n\n### Primary Server\n\n```bash\ndocker run -it -d --name=tinc \\\n    -e NETWORK_NAME=vpn \\\n    -e NETWORK_ADDRESS=10.250.0.1 \\\n    -e NETWORK_PREFIX=24 \\\n    -e NODE_NAME=myhostname \\\n    -e SERVER=1 \\\n    --net=host \\\n    --device=/dev/net/tun \\\n    --cap-add=NET_ADMIN \\\n    --restart=always \\\n    -v tinc_etc:/etc/tinc wildwildangel/tinc:latest\n```\n\nThis will create a network called `vpn` (10.250.0.0/24), and set 10.250.0.1 as node's IP address.\n\n  * `NETWORK_NAME` (default: `vpn`): [network name](https://manpages.debian.org/experimental/tinc/tinc.conf.5.en.html#NAMES)\n  * `NETWORK_ADDRESS`: IP address for the node (must be unique for every node)\n  * `NETWORK_PREFIX` (24 if omitted): network address prefix\n  * `NODE_NAME`: node identifier for tinc ([only alphanumeric characters and underscore are allowed](https://manpages.debian.org/experimental/tinc/tinc.conf.5.en.html#NAMES))\n  * `SERVER`: must be set to a non-empty string for the primary server\n\n### Add a New Node\n\nFirst, please make sure that the firewall does not block 655/tcp and 655/udp,\n\nNext, you will need to run this command on the *primary* server:\n```bash\ndocker exec -it tinc tinc -n vpn -b invite client\n```\n\nwhere `client` is the name of the node to add.\n\nThe command will produce something like this:\n```\nExecuting script invitation-created\nprimary.server.name:655/H9dJ1-IypO43yEdy9BIUBRCsZBHfoEvGnAJTXnlblzX_ZwaQ\n```\n\nYou will need the last line of the output, this is the secret link to join the VPN. Then, please run this on the node being added:\n```bash\ndocker run -it -d --name=tinc \\\n    -e NETWORK_ADDRESS=10.250.0.2 \\\n    -e NETWORK_PREFIX=24 \\\n    -e INVITE_URL=that_long_invitation_url_from_the_previous_step \\\n    --net=host \\\n    --device=/dev/net/tun \\\n    --cap-add=NET_ADMIN \\\n    --restart=always \\\n    -v tinc_etc:/etc/tinc \\\n    wildwildangel/tinc:latest\n```\n\n`NETWORK_PREFIX` variables should match across all nodes, `NETWORK_ADDRESS` must obviously be unique.\n\nPlease note that `SERVER` environment variable must not be passed to client nodes (or at least be empty). `NODE_NAME` is not used, because the client will receive its name from the server.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsjinks%2Fdocker-tinc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsjinks%2Fdocker-tinc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsjinks%2Fdocker-tinc/lists"}