# Install aliddns with Homebrew

Aliyun(Alibaba Cloud) ddns for golang. Version 0.0.23 via Homebrew; verified from local package data.

## 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>
- **Upstream docs:** <https://github.com/OpenIoTHub/aliddns#readme>
- **License:** MIT
- **Source archive:** <https://github.com/OpenIoTHub/aliddns.git>
- **Generated:** 2026-07-08T07:18:31+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-07-08
- Package-manager version: 0.0.23
- Local data: ok
- Upstream repository: https://github.com/OpenIoTHub/aliddns
- info: No package-manager update timestamp was available.
- 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://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [adns](https://www.automicvault.com/pkg/brew/adns/) - Shares av.db curated category or tags: cli, dns, networking.
- [bind](https://www.automicvault.com/pkg/brew/bind/) - Shares av.db curated category or tags: cli, dns, networking.
- [c-ares](https://www.automicvault.com/pkg/brew/c-ares/) - Shares av.db curated category or tags: cli, dns, networking.
- [cdncheck](https://www.automicvault.com/pkg/brew/cdncheck/) - Shares av.db curated category or tags: cli, dns, networking.
- [checkdmarc](https://www.automicvault.com/pkg/brew/checkdmarc/) - Shares av.db curated category or tags: cli, dns, networking.
- [chinadns-c](https://www.automicvault.com/pkg/brew/chinadns-c/) - Shares av.db curated category or tags: cli, dns, networking.
- [coredns](https://www.automicvault.com/pkg/brew/coredns/) - Shares av.db curated category or tags: cli, dns, networking.
- [ctrld](https://www.automicvault.com/pkg/brew/ctrld/) - Shares av.db curated category or tags: cli, dns, networking.
- [ddns-go](https://www.automicvault.com/pkg/brew/ddns-go/) - Local package facts share a topical domain. Shared terms: cli, ddns, dns, networking.

## Combined YAML source

View the package source record on GitHub. [combined/aliddns.yml](https://github.com/automic-vault/db/blob/main/combined/aliddns.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
