# Install aliddns with Homebrew

Aliyun(Alibaba Cloud) ddns for golang. Version 0.0.23 via Homebrew; verified 2026-07-27.

## Install

```sh
sudo av install brew:aliddns
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install aliddns
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:aliddns
- **Package manager:** Homebrew
- **Version:** 0.0.23
- **Source summary:** Aliyun(Alibaba Cloud) ddns for golang
- **Homepage:** <https://github.com/OpenIoTHub/aliddns>
- **Repository:** <https://github.com/OpenIoTHub/aliddns>
- **Last updated:** 2026-07-27T08:43:19-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- aliddns (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.0.23
## Project history and usage

aliddns is a Go dynamic DNS client for Aliyun or Alibaba Cloud DNS. It updates a DNS record from a changing public IP address, a common home-lab and small-server need.

### Project history

The public GitHub repository was created in September 2020 under OpenIoTHub/aliddns. The official repository description and README present it as an Aliyun DDNS service written in Go, with convenient installation and background-service operation on Linux and macOS.

The project is small and task-focused: configure Alibaba Cloud access credentials, domain, subdomain, and update interval, then run it directly or as a packaged service.

### Adoption history

The README documents distribution through Homebrew tap, Homebrew core, Snapcraft, Scoop, deb/rpm packages, shell installer, manual release binaries, and Docker. Official GitHub topics also list brew, deb, rpm, snapcraft, scoop, Docker, OpenWrt, Windows, Linux, and macOS.

The adoption audience is mostly users in Aliyun/Alibaba Cloud DNS environments who need DDNS for residential or changing-IP networks.

### How it is used

The README shows `aliddns -c /path/to/config/file/aliddns.yaml`, plain `aliddns` using `./aliddns.yaml`, and `aliddns run -i myid -k mykey -m iothub.cloud -s www -c 60`. The `-i` and `-k` values are the Alibaba Cloud access ID and access key.

For packaged services, the README lists `/etc/aliddns/aliddns.yaml` for deb/rpm installs and `/root/snap/aliddns/current/aliddns.yaml` for Snap. Those config files also contain credentials, so they should be treated as secret-bearing files.

### Why package nerds care

aliddns is a classic package-manager utility: small, single-purpose, and much nicer when installed as a service rather than copied around as a one-off script.

Its packaging breadth is notable for a niche regional-cloud DDNS client, especially because it covers desktop package managers, Linux service packages, Snap, Docker, and router-adjacent environments.

### Timeline

- 2020: Public GitHub repository created.
- 2020s: README documents Homebrew, Snap, Scoop, deb/rpm, Docker, and release-binary installation paths.
- 2023: Official GitHub metadata shows the last repository push in October 2023 at the time checked.

### Related projects

- Related projects include other DDNS clients, Alibaba Cloud DNS automation scripts, router DDNS integrations, and OpenIoTHub networking utilities.

### Sources

- <https://api.github.com/repos/OpenIoTHub/aliddns>
- <https://github.com/OpenIoTHub/aliddns>
- <https://raw.githubusercontent.com/OpenIoTHub/aliddns/master/README.md>
- source_facts.package-manager


## Security Notes

formula declares a Homebrew service. infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- formula declares a Homebrew service
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ./aliddns.yaml, /etc/aliddns/aliddns.yaml, /root/snap/aliddns/current/aliddns.yaml

## Credential files

- Unix: ./aliddns.yaml, /etc/aliddns/aliddns.yaml, /root/snap/aliddns/current/aliddns.yaml

## Combined YAML source

View the package source record on GitHub. [combined/aliddns.yml](https://github.com/mxcl/pkgdb/blob/main/combined/aliddns.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph