Download Latest Version uncloud_linux_amd64.tar.gz (33.9 MB)
Email in envelope

Get an email when there's a new version of Uncloud

Home / v0.17.1
Name Modified Size InfoDownloads / Week
Parent folder
uncloud_linux_amd64.tar.gz 2026-03-09 33.3 MB
uncloud_macos_arm64.tar.gz 2026-03-09 30.9 MB
checksums.txt 2026-03-09 560 Bytes
uncloud_linux_arm64.tar.gz 2026-03-09 30.2 MB
uncloud_macos_amd64.tar.gz 2026-03-09 33.3 MB
uncloudd_linux_amd64.tar.gz 2026-03-09 19.9 MB
uncloudd_linux_arm64.tar.gz 2026-03-09 18.1 MB
README.md 2026-03-09 3.9 kB
v0.17.1 source code.tar.gz 2026-03-09 2.7 MB
v0.17.1 source code.zip 2026-03-09 2.9 MB
Totals: 10 Items   171.5 MB 1

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.

:::shell
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:

:::shell
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.

:::yaml
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

Upgrade to 0.17.1

Uncloud CLI locally

To upgrade the Uncloud CLI (uc) locally:

:::bash
# 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:

:::bash
# 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

Changelog

  • [d5687c] chore: combine some e2e tests to reduce the number of ucind clusters hence used system resources
  • [4de17c] chore: delete the obsolete 'machine token' command
  • [e54871] chore: increase wait for test cluster timeout 30s -> 60s for e2e tests on GHA
  • [38c7dd] chore: rename --endpoint to --wg-endpoint for 'uc machine update' command
  • [897f03] chore: skip not found services when streaming logs for Compose services (print warning)
  • [2405b1] chore: validate endpoints is not empty in update machine requests
  • [a67f93] chore: wait for known missing changes during the initial cluster store sync
  • [51c7b5] feat: add --wg-endpoint flag to 'uc machine add/init' to specify wireguard endpoint for the machine instead of auto-detecting
  • [bad0f9] feat: add support for updating WireGuard endpoints for a machine (uc machine update)
  • [d9934b] feat: support compose stop_grace_period to change timeout before sending SIGKILL
  • [7b306f] fix: another attempt to fix flaky test container_crashes_on_startup_without_healthcheck
  • [222243] fix: connection formatting when changing connection with 'ctx conn'
  • [a507b2] fix: create AAAA DNS record for IPv6 machines" (#257)
  • [3c4354] fix: flaky test TestDeployment/container_crashes_on_startup_without_healthcheck
  • [1f328e] fix: remove the incorrect e2e test for updating machine endpoints with empty list
  • [e6f013] fix: skip Tailscale addresses for using as auto-detected WireGuard endpoints
  • [51b8c2] fix: typo
Source: README.md, updated 2026-03-09