# 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
- **Package manager page:** <https://formulae.brew.sh/formula/aliddns>
- **Version:** 0.0.23
- **Source summary:** Aliyun(Alibaba Cloud) ddns for golang
- **Homepage:** <https://github.com/OpenIoTHub/aliddns>
- **Repository:** <https://github.com/OpenIoTHub/aliddns>
- **License:** MIT
- **Source archive:** <https://github.com/OpenIoTHub/aliddns.git>
- **Last updated:** 2026-07-27T08:43:19-04:00
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- aliddns (cli)
- aliddns (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Service: declared
- Bottle: available on arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 0.0.23
- Package-manager updated: 2026-07-27
- Local data: ok
- Upstream repository: https://github.com/OpenIoTHub/aliddns
- info: No cached GitHub release or tag data was available.
## 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
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** aliddns
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://pkg.so/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://pkg.so/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [go](https://pkg.so/brew/go/) - Build dependency declared by Homebrew.
- [doggo](https://pkg.so/brew/doggo/) - Shares pkgdb curated category or tags: cli, dns, go, networking.
- [coredns](https://pkg.so/brew/coredns/) - Shares pkgdb curated category or tags: cli, dns, go, networking.
- [sdns](https://pkg.so/brew/sdns/) - Shares pkgdb curated category or tags: cli, dns, go, networking.
- [libidn2](https://pkg.so/brew/libidn2/) - Shares pkgdb curated category or tags: cli, dns, networking.
- [libidn](https://pkg.so/brew/libidn/) - Shares pkgdb curated category or tags: cli, dns, networking.
- [dnsmasq](https://pkg.so/brew/dnsmasq/) - Shares pkgdb curated category or tags: cli, dns, networking.
- [ldns](https://pkg.so/brew/ldns/) - Shares pkgdb curated category or tags: cli, dns, networking.
- [bind](https://pkg.so/brew/bind/) - Shares pkgdb curated category or tags: cli, dns, networking.
- [ddns-go](https://pkg.so/brew/ddns-go/) - Local package facts share a topical domain. Shared terms: cli, ddns, dns, networking.
- [chinadns-c](https://pkg.so/brew/chinadns-c/) - Local package facts share a topical domain. Shared terms: cli, dns, networking.
- [ctrld](https://pkg.so/brew/ctrld/) - Local package facts share a topical domain. Shared terms: cli, dns, networking.

## 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
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph
