tailscale

# Tailscale - Service Exposure via Tailnet

## Overview

The `tailscale` command manages Tailscale Serve to expose local bazzite-ai services to your tailnet. It provides HTTPS endpoints with auto-provisioned certificates.

**Key Concept:** Tailscale Serve exposes local services only to your tailnet (not the public internet). HTTPS certificates are automatically provisioned and managed by Tailscale.

## Quick Reference

| Action | Command | Description |
|--------|---------|-------------|
| List | `ujust tailscale list` | List available bazzite-ai services |
| Serve | `ujust tailscale serve SERVICE [--port=N]` | Expose service to tailnet via HTTPS |
| Status | `ujust tailscale status` | Show current serve configuration |

## Prerequisites

```bash
# Tailscale must be installed and logged in
sudo dnf install tailscale
sudo systemctl enable --now tailscaled
tailscale up
```

## Parameters

| Parameter | Long Flag | Short | Default | Description |
|-----------|-----------|-------|---------|-------------|
| action | (positional) | - | required | Action: serve, unserve, status, list |
| service | `--service` | `-s` | `""` | Service name or port number |
| port | `--port` | `-p` | `""` | Tailscale HTTPS port to expose on |

## Known Services

| Service | Default Port | Description |
|---------|--------------|-------------|
| `jupyter` | 8888 | JupyterLab notebooks |
| `ollama` | 11434 | Ollama LLM API |
| `comfyui` | 8188 | ComfyUI Stable Diffusion |
| `openwebui` | 3000 | Open WebUI chat interface |
| `fiftyone` | 5151 | FiftyOne dataset visualization |

## Serve Commands

### Serve by Service Name

```bash
# Auto-detect port for known services (long form)
ujust tailscale serve --service=jupyter

# Auto-detect port for known services (short form)
ujust tailscale serve -s jupyter

# Serve ollama
ujust tailscale serve -s ollama

# Serve comfyui
ujust tailscale serve -s comfyui

# Serve openwebui
ujust tailscale serve -s openwebui
```

### Serve by Port Number

```bash
# Ser