pikvm/docs/tailscale.md

# Tailscale VPN

[Tailscale](https://tailscale.com/) can be used to access PiKVM on the internal network. This is a convenient and free (for private use) tool for organizing a small VPN network. This document is provided as an example for accessing your pikvm over the inet but you can also use zerotier or remote.it. Basic support like whats shown below is provided as an example, any other setting or functionality needs to be redirected to the appropriate community.


## Installation

### On the PiKVM side

1. Use these commands:

    ```
    # rw
    # pacman -Syu tailscale-pikvm
    # systemctl enable --now tailscaled
    # tailscale up
    ```

2. Follow the link to authorize this installation.

3. After success, perform soft reboot using `reboot` command to make sure that everything will work correctly.

4. Perform command `ip addr show tailscale0` to view the Tailscale IP address.


### For each device you wish to access pikvm

* [Download](https://tailscale.com/download) and install tailscale for your OS to the system you are using, not to the system you want to control.
* 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.

??? note
    * BASIC troubleshooting in case this fails in some way: Uninstall tailscale, remove these dirs /var/lib/tailscale /var/cache/tailscale and reinstall
    
    ```
    # pacman -Rscnd tailscale
    # rm -rf /var/lib/tailscale /var/cache/tailscale
    # reboot
    ```
    
    * Follow the above instructions to reinstall
docs.pikvm.org 2021-10-12 18:45:00 +00:00			`# Tailscale VPN`

			`[Tailscale](https://tailscale.com/) can be used to access PiKVM on the internal network. This is a convenient and free (for private use) tool for organizing a small VPN network. This document is provided as an example for accessing your pikvm over the inet but you can also use zerotier or remote.it. Basic support like whats shown below is provided as an example, any other setting or functionality needs to be redirected to the appropriate community.`


			`## Installation`

			`### On the PiKVM side`

			`1. Use these commands:`

			```
			`# rw`
update documentation to reflect best-practices (#857) * update tailscale.md to reflect best-practices The provided -Syy is supposed to be used to redownload all package databases, while the command chain itself is a partial upgrade which is not recommended either for rolling release distributions. Replace the full database redownload with a database update and run a system upgrade while installing tailscaled. * remove unnecessary sync command from video.md * remove unnecessary sync command from bluetooth_hid.md * remove unnecessary sync command from arduino_hid.md * update faq.md to reflect best practices * update letsencrypt.md to keep system up-to-date when installing packages 2022-11-09 19:16:22 +00:00			`# pacman -Syu tailscale-pikvm`
docs.pikvm.org 2021-10-12 18:45:00 +00:00			`# systemctl enable --now tailscaled`
			`# tailscale up`
			```

			`2. Follow the link to authorize this installation.`

			3. After success, perform soft reboot using `reboot` command to make sure that everything will work correctly.

			4. Perform command `ip addr show tailscale0` to view the Tailscale IP address.


Update tailscale.md (#621) Changed verbiage for clarification 2022-01-25 04:22:05 +00:00			`### For each device you wish to access pikvm`
docs.pikvm.org 2021-10-12 18:45:00 +00:00
Update tailscale.md (#755) Added verbiage for clarity. 2022-06-22 19:54:43 +00:00			`* [Download](https://tailscale.com/download) and install tailscale for your OS to the system you are using, not to the system you want to control.`
docs.pikvm.org 2021-10-12 18:45:00 +00:00			`* 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.
Update tailscale.md (#815) * Update tailscale.md Added basic troubleshooting * Update tailscale.md edited per request 2022-09-04 19:01:44 +00:00
			`??? note`
			`* BASIC troubleshooting in case this fails in some way: Uninstall tailscale, remove these dirs /var/lib/tailscale /var/cache/tailscale and reinstall`

			```
			`# pacman -Rscnd tailscale`
			`# rm -rf /var/lib/tailscale /var/cache/tailscale`
			`# reboot`
			```

			`* Follow the above instructions to reinstall`