Installation

Desktop App

Download and open — Unne asks for your server and token, then installs itself into Applications / the Start menu:

• macOS: Unne-macOS.zip (Apple Silicon and Intel)
• Windows: x64 · ARM
• Linux: install the command line below, then run unne app install

See Desktop App.

Command Line

macOS / Linux

curl -fsSL https://unne.site/cli/install | bash

Windows (PowerShell)

irm https://unne.site/cli/install.ps1 | iex

Manual Download

Download the binary for your platform from GitHub Releases:

File	Platform
unne-darwin-amd64	macOS Intel
unne-darwin-arm64	macOS Apple Silicon
unne-linux-amd64	Linux x86_64
unne-linux-arm64	Linux ARM64
unne-windows-amd64.exe	Windows x64

macOS / Linux (manual)

# Example: macOS Apple Silicon
curl -fsSL -o unne https://github.com/unne-cli/core/releases/download/latest/unne-darwin-arm64
chmod +x unne
sudo mv unne /usr/local/bin/

Windows (manual)

Download unne-windows-amd64.exe and add it to your PATH.

First-Time Setup

After installation, configure the CLI:

unne setup

This creates ~/.unne/settings.yml with your server connection details:

server: "unne.site"
port: 8222
authtoken: "your-auth-token"

Verify Connection

unne check

This confirms that the CLI can reach the Unne Server.

Usage

Unne CLI v2.0.1 - Self-hosted tunnel solution

Usage:
  unne setup                        Configure server connection
  unne http <port>                  Quick HTTP tunnel
  unne tcp <port>                   Quick TCP tunnel
  unne start                        Start tunnels from unne.yml
  unne domains                      List your reserved subdomains
  unne check                        Check server connectivity
  unne ui                           Web app to manage and inspect tunnels
  unne tray [install]               Menu bar / tray icon (install: app shortcut + login)
  unne window                       Open Unne in a native window
  unne service install|uninstall|status
                                    Run in the background from start-up
  unne update [--check]             Update to the latest version
  unne version                      Show version

Options:
  --config, -c <path>               Config file path (default: unne.yml)
  --subdomain, --domain, -s <name>  Desired subdomain (http only)
  --remote-port, -rp <port>         Remote port (tcp only)
  --proxy, -p <url>                 Proxy URL (socks5:// or http://)
  --skip-warning, --sw              Skip browser warning page
  --no-tui                          Disable TUI, log-only mode
  --webui, -w                       Enable web inspector
  --webui-port, -wp <port>          Web inspector port (default: 4040)

Updating

unne update          # download the latest release and replace the binary
unne update --check  # only check

unne update downloads the build for your OS and architecture from GitHub Releases and replaces the binary in place (on Windows the old file is kept as unne.exe.old and removed on the next start). If the background service is installed, it is restarted on the new version. unne ui also shows an Update now button when a new release is out.

If the binary lives in a system directory (e.g. /usr/local/bin), run sudo unne update.