| Name | Modified | Size | Downloads / 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 logsnow 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 tokencommand
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:
:::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