Skip to content

Repository files navigation

Set up WireGuard

Test

This GitHub action sets up a WireGuard connection in your workflow run.

  1. Installs WireGuard if it's missing.
  2. Sets up a connection using the provided credentials.

Use it your workflow like this:

- name: Set up WireGuard
uses: egor-tensin/setup-wireguard@v1
with:
endpoint: 46.46.46.46:51820
endpoint_public_key: 9IHlvJqgkVWMq57a0A56XI5IjhnL5gaRhI1Pszk7S24=
ips: 192.168.143.254/24,fd8c:bc10:5021::192.168.143.254/48
allowed_ips: 192.168.143.0/24,fd8c:bc10:5021::/48
private_key: GLEiXhRwFuhw8aPy+HQfSMwwoLU0Sw8jE8MOxZ8GV3w=
preshared_key: PWAfvVWCjiNV0Uh2DhmXhdRaT326qosSOcaDB3j9dwI=

Of couse it's highly advised to store all sensitive data in your repository's secrets. It could then become something like:

- name: Set up WireGuard
uses: egor-tensin/setup-wireguard@v1
with:
endpoint: '${{ secrets.ENDPOINT }}'
endpoint_public_key: '${{ secrets.ENDPOINT_PUBLIC }}'
ips: '${{ secrets.IPS }}'
allowed_ips: '${{ secrets.ALLOWED_IPS }}'
private_key: '${{ secrets.PRIVATE }}'
preshared_key: '${{ secrets.PRESHARED }}'

API

InputExampleDescription
endpoint46.46.46.46:51820Endpoint to connect to in the HOST:PORT format.
endpoint_public_key9IHlvJqgkVWMq57a0A56XI5IjhnL5gaRhI1Pszk7S24=Endpoint's public key.
ips192.168.143.254/24,fd8c:bc10:5021::192.168.143.254/48Comma-separated list of IP addresses to assign to the VM.
allowed_ips192.168.143.0/24,fd8c:bc10:5021::/48Comma-separated list of netmasks.
private_keyGLEiXhRwFuhw8aPy+HQfSMwwoLU0Sw8jE8MOxZ8GV3w=Private key of the VM.
preshared_keyPWAfvVWCjiNV0Uh2DhmXhdRaT326qosSOcaDB3j9dwI=Preshared key assigned to the VM.
keepalive25Useful for NAT traversal.

License

Distributed under the MIT License. See LICENSE.txt for details.

About

GitHub action to set up WireGuard

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages