📘

Tailscale

Tailscale is currently offered as a Beta on our platform and may not function as expected in all situations. We cannot provide official support for issues, troubleshooting, or compatibility problems that may arise from its usage. We recommend using Tailscale only if you are comfortable with potential instability or limitations.

By using Tailscale in its Beta state, you acknowledge that you do so at your own discretion and that its functionality may change or be removed without further notice.

Tailscale lets you securely access your service’s web applications through a private network. Once set up, you can open apps like Deluge from your own devices without public ports.

Prerequisites

A personal email address (Gmail, Outlook, etc.).

Do not use custom domains since Tailscale treats them as business accounts.

Access to your UCP to view your service details (host, SSH port, username).
An SSH client on your computer.

Initial Setup

Create a Tailscale account
Go to Tailscale and sign up with your personal email.

Do not use custom domains since Tailscale treats them as business accounts.

Download and set up Tailscale on the computer or phone you will use to connect (Windows, macOS, Linux, iOS, Android).

In the Tailscale Admin console, create an authentication key.

Take note of the auth key for the next step.

Next, connect to your Ultra service via SSH.
Install Tailscale by executing the following command:

Make sure to replace <your_auth_key_here> with the authentication key you previously noted down.

app-tailscale install -p <your_auth_key_here>

After installation, your Ultra service should appear in your Tailscale Admin devices list.

Test Connection

Open your Tailscale Admin Console and verify your service shows as connected.
Open your apps over the Tailscale IP

Copy the Tailscale IP for your service from the Admin page.
Visit your app using the IP and port in your browser.

http://100.xxx.xxx.xxx:port

(Optional) Ping test

From your computer while connected to Tailscale.

ping 100.xxx.xxx.xxx

Troubleshooting Information

“app-tailscale: command not found”

Make sure you are SSH’d into the correct service.

Device not showing in Tailscale Admin

Reattempt the installation with a fresh auth key.
Confirm you are logged into the same Tailscale account on your device and in the Admin console.

Cannot open apps in the browser

Use the Tailscale IP with http:// and the correct port. Hostnames are not supported.

Auth key errors

Some keys are single-use or expire quickly. Generate a new key and try again.

Connectivity drops after some time

Reconnect your local Tailscale client.
Check Tailscale service status.

app-tailscale status

If needed, restart the Tailscale service.

app-tailscale restart

Limitations

Only HTTP over Tailscale IP is available.
Hostnames are not supported.
HTTPS certificates are not supported.
Exit node functionality is not available.
Filebrowser does not work.
rTorrent does not work.

If you require further assistance, you can open a support ticket here!

Feedback and suggestions regarding this article are welcome on our Discord server

Tailscale
Prerequisites
Initial Setup
Test Connection
Troubleshooting Information
“app-tailscale: command not found”
Device not showing in Tailscale Admin
Cannot open apps in the browser
Auth key errors
Connectivity drops after some time
Limitations