You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
pikvm/docs/tailscale.md

67 lines
2.2 KiB
Markdown

3 years ago
# Tailscale VPN
11 months ago
The [Tailscale VPN](https://tailscale.com/) can be used to access PiKVM from the Internet
11 months ago
when using [port forwarding](port_forwarding.md) is not possible or does not seem secure enough.
Tailscale is a convenient and free (for private use) tool for organizing a small VPN network.
3 years ago
11 months ago
Basic Tailscale usage like whats shown below is provided as an example,
11 months ago
any other setting or functionality needs to be redirected to the [Tailscale support](https://tailscale.com/contact/support/).
11 months ago
-----
## Configuring the PiKVM
3 years ago
11 months ago
1. Install the client, run `tailscaled` service and register it in the network:
3 years ago
11 months ago
```console
11 months ago
[root@pikvm ~]# rw
[root@pikvm ~]# pacman -Syu
[root@pikvm ~]# pacman -S tailscale-pikvm
[root@pikvm ~]# systemctl enable --now tailscaled
[root@pikvm ~]# tailscale up
3 years ago
```
2. Follow the link to authorize this installation.
11 months ago
3. After success, perform reboot to make sure that everything is working correctly:
11 months ago
11 months ago
```console
11 months ago
[root@pikvm ~]# reboot
```
4. Now you can try to view the IP address of Tailscale network interface:
11 months ago
```console
11 months ago
[root@pikvm ~]# ip addr show tailscale0
```
3 years ago
11 months ago
If everything is successful, PiKVM will become a member of your VPN network.
11 months ago
!!! warning "Do not update Tailscale if you don't have access to PiKVM without VPN"
Unfortunately sometimes updating the Tailscale client can cause problems due breaking changes.
This is a reality that has to be taken into account.
3 years ago
11 months ago
-----
## Configuring a client device
11 months ago
* [Download](https://tailscale.com/download) and install the Tailscale client for your OS
to the system you are using (not to the system you want to control).
3 years ago
* Check the [admin page](https://login.tailscale.com/admin/machines) to view your VPN network.
* Follow the URL in the web browser: `https://<tailscale_kvm_ip>` and you will see PiKVM web interface.
11 months ago
11 months ago
-----
11 months ago
## Troubleshooting
11 months ago
If something not work, the usual advice is to completely remove the Tailscale from PiKVM and perform a clean installation:
11 months ago
11 months ago
```console
11 months ago
[root@pikvm ~]# rw
[root@pikvm ~]# pacman -Rscnd tailscale
[root@pikvm ~]# rm -rf /var/lib/tailscale /var/cache/tailscale
[root@pikvm ~]# reboot
11 months ago
```
11 months ago
Next, follow this page from the beginning to install the Tailscale again.