uncloud/website/docs/10-release-notes/v0.17.1.md

sidebar_position, sidebar_label

sidebar_position	sidebar_label
-17.1	v0.17.1

v0.17.1

This page mirrors the GitHub release, which also includes the full list of commits.

This is small patch release that adds WireGuard endpoint management for machines, Compose stop_grace_period support, and several networking fixes.

WireGuard endpoint management

You can now manually specify what WireGuard endpoint to use when adding or initialising a machine instead of relying on auto-detection. This is useful when a machine is behind a NAT or has multiple network interfaces.

uc machine init user@host --wg-endpoint 203.0.113.1
uc machine add user@host --wg-endpoint 203.0.113.2 --wg-endpoint 192.168.1.5

You can also update the WireGuard endpoint for an existing machine:

uc machine update my-machine --wg-endpoint 203.0.113.1

Compose stop_grace_period support

Control how long to wait before sending SIGKILL to a container during replacements and stops.

services:
  app:
    image: myapp
    stop_grace_period: 30s

Improvements

• Tailscale addresses are excluded from auto-detected WireGuard endpoints: see Discord thread
• uc logs now prints a warning and continues instead of failing when some Compose services are not found in the cluster
• Improved reliability of the initial cluster store sync by waiting for known missing changes
• Removed the obsolete uc machine token command

Bug fixes

• Fixed Uncloud DNS resolution for IPv6 machines by creating AAAA records: https://github.com/psviderski/uncloud/pull/257
• Fixed connection formatting when changing connection with uc ctx conn

Upgrade to 0.17.1

Uncloud CLI locally

To upgrade the Uncloud CLI (uc) locally:

# Homebrew (macOS, Linux)
brew upgrade uncloud

# Install script (macOS, Linux)
curl -fsS https://get.uncloud.run/install.sh | sh

Machine daemon

To upgrade the Uncloud daemon on your machines, run the following commands on each machine:

# AMD64
curl -fsSL -o uncloudd.tar.gz https://github.com/psviderski/uncloud/releases/download/v0.17.1/uncloudd_linux_amd64.tar.gz
# ARM64
# curl -fsSL -o uncloudd.tar.gz https://github.com/psviderski/uncloud/releases/download/v0.17.1/uncloudd_linux_arm64.tar.gz
tar -xf uncloudd.tar.gz
sudo install uncloudd /usr/local/bin/uncloudd
rm uncloudd uncloudd.tar.gz
sudo systemctl restart uncloud