# Install incus with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, winget, zypper

CLI client for interacting with Incus. Version 7.2 via Homebrew; verified 2026-06-26.

## Install

```sh
sudo av install brew:incus
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install incus
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install incus
```

  Evidence: MacPorts ports tree: net/incus/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add incus
```

  Evidence: Alpine Linux edge package indexes: incus from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install golang-github-lxc-incus-dev
```

  Evidence: Debian stable package indexes: golang-github-lxc-incus-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install incus
```

  Evidence: Fedora Rawhide package metadata: incus from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#incus
```

  Evidence: nixpkgs package indexes: pkgs/by-name/in/incus/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S incus
```

  Evidence: Arch Linux sync databases: incus from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install incus
```

  Evidence: openSUSE Tumbleweed package metadata: incus from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- winget (92%):

```sh
winget install --id LinuxContainers.Incus -e
```

  Evidence: Windows Package Manager source index: LinuxContainers.Incus from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:incus
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/incus>
- **Version:** 7.2
- **Source summary:** CLI client for interacting with Incus
- **Homepage:** <https://linuxcontainers.org/incus>
- **Repository:** <https://github.com/lxc/incus>
- **Upstream docs:** <https://linuxcontainers.org/incus/docs/main>
- **License:** Apache-2.0
- **Source archive:** <https://linuxcontainers.org/downloads/incus/incus-7.2.tar.xz>
- **Last updated:** 2026-06-26T11:02:49Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- incus (cli)
- incus (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 7.2
- Package-manager updated: 2026-06-26
- Local data: ok
- Upstream repository: https://linuxcontainers.org/incus
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Incus is a system container and virtual machine manager from the Linux Containers community. It packages the LXD-style private-cloud workflow under the incus CLI: images, instances, profiles, storage, networking, clustering, and a REST API for running full Linux systems in containers or virtual machines.

### Project history

Incus began in 2023 as a community fork of Canonical LXD after LXD moved away from the Linux Containers community. The Incus README says the project was adopted by Linux Containers, is maintained by the same developer team that first created LXD, and remains Apache-2.0 without a contributor license agreement.

The first Incus release was 0.1 on October 7, 2023. The release announcement described it as close to LXD 5.18 while using the fork point to remove or rename legacy interfaces, drop features tied to Canonical-specific infrastructure, switch the guest API from /dev/lxd to /dev/incus, and introduce cleaner CLI flows such as incus snapshot and incus admin.

Incus also inherited the broader Linux Containers ecosystem: LXC for system containers, image distribution through the Linux Containers infrastructure, clustering concepts from LXD, and Cowsql as the community fork of Dqlite used for replicated state.

### Adoption history

Incus adoption followed a migration path from LXD: users who wanted the Linux Containers governance model could keep a familiar API and CLI shape while moving to the incus command and renamed daemon. The README emphasizes usage from a single host to a full rack-scale cluster, and Homebrew metadata in the input shows packages across Homebrew, Alpine, Fedora, Arch, Nix, MacPorts, openSUSE, Debian/Ubuntu development packages, and Windows winget.

### How it is used

Users run incus to create and manage instances, images, networks, storage pools, profiles, projects, clusters, snapshots, and remotes. The tool is especially common where operators want VM-like full-system environments with container density, or a local private-cloud control plane for development labs, CI workers, and small infrastructure clusters.

### Why package nerds care

Incus matters to package people because it is both a package and an ecosystem boundary marker: the package name, binary name, guest device path, config path, service name, and migration story all reflect the LXD-to-Incus governance split. It is also a good example of why package managers preserve community forks quickly when upstream ownership or distribution assumptions change.

For Homebrew specifically, incus is notable because the formula delivers the client-side tool for a Linux-first infrastructure project to macOS users, where the CLI can still manage remote Incus servers.

### Timeline

- 2023: Incus repository created under the lxc GitHub organization.
- 2023: Incus 0.1 released as a community fork roughly equivalent to LXD 5.18.
- 2024: Incus 6.0 LTS established a long-term-support line.
- 2026: Incus 7.0 LTS and 7.x releases continued the post-fork release train.

### Related projects

- LXD is the direct upstream lineage. LXC remains the low-level container technology in the same Linux Containers family. Cowsql is the community fork of Dqlite used by Incus for clustered database state. Zabbly provides commercial packaging support referenced by the Incus README.

### Sources

- <https://discuss.linuxcontainers.org/t/incus-0-1-has-been-released/18036>
- <https://github.com/lxc/incus>
- <https://github.com/lxc/incus/releases/>
- <https://linuxcontainers.org/incus/docs/main/>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool 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: ~/.config/incus/config.yml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** incus
- **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

## Other Package-Manager Records

- Debian apt - golang-github-lxc-incus-dev - 6.0.4-2+deb13u7: normalized package name match | Debian stable package indexes: golang-github-lxc-incus-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Powerful system container and virtual machine manager - library | https://linuxcontainers.org/incus/
- Debian apt - incus - 6.0.4-2+deb13u7: normalized package name match | Debian stable package indexes: incus from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Powerful system container and virtual machine manager - daemon | https://linuxcontainers.org/incus/
- Debian apt - incus-agent - 6.0.4-2+deb13u7: normalized package name match | Debian stable package indexes: incus-agent from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Incus guest agent | https://linuxcontainers.org/incus/
- Debian apt - incus-base - 6.0.4-2+deb13u7: normalized package name match | Debian stable package indexes: incus-base from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Powerful system container and virtual machine manager - daemon (container-only) | https://linuxcontainers.org/incus/
- Debian apt - incus-client - 6.0.4-2+deb13u7: normalized package name match | Debian stable package indexes: incus-client from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Powerful system container and virtual machine manager - client | https://linuxcontainers.org/incus/
- Debian apt - incus-extra - 6.0.4-2+deb13u7: normalized package name match | Debian stable package indexes: incus-extra from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Powerful system container and virtual machine manager - extra tools | https://linuxcontainers.org/incus/
- Nix - incus: normalized package name match | nixpkgs package indexes: pkgs/by-name/in/incus/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - golang-github-lxc-incus-dev - 6.0.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: golang-github-lxc-incus-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Powerful system container and virtual machine manager - library | https://linuxcontainers.org/incus/
- Ubuntu apt - incus - 6.0.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: incus from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Powerful system container and virtual machine manager - daemon | https://linuxcontainers.org/incus/
- Ubuntu apt - incus-agent - 6.0.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: incus-agent from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Incus guest agent | https://linuxcontainers.org/incus/
- Ubuntu apt - incus-client - 6.0.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: incus-client from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Powerful system container and virtual machine manager - client | https://linuxcontainers.org/incus/
- Ubuntu apt - incus-migrate - 6.0.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: incus-migrate from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Incus physical to instance migration tool | https://linuxcontainers.org/incus/
- Ubuntu apt - incus-tools - 6.0.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: incus-tools from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Powerful system container and virtual machine manager - extra tools | https://linuxcontainers.org/incus/
- apk - incus - 7.0.0-r3: normalized package name match | Alpine Linux edge package indexes: incus from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Powerful system container and virtual machine manager | https://github.com/lxc/incus
- apk - incus-vm - 7.0.0-r3: normalized package name match | Alpine Linux edge package indexes: incus-vm from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Install packages required to run VMs under Incus | https://github.com/lxc/incus
- dnf - incus - 6.23-3.fc45: normalized package name match | Fedora Rawhide package metadata: incus from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Powerful system container and virtual machine manager | https://linuxcontainers.org/incus


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure 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.
- [lxc](https://www.automicvault.com/pkg/brew/lxc/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, linux, virtual-machines.
- [colima](https://www.automicvault.com/pkg/brew/colima/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, linux, virtualization.
- [pvetui](https://www.automicvault.com/pkg/brew/pvetui/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, infrastructure, virtualization.
- [rootlesskit](https://www.automicvault.com/pkg/brew/rootlesskit/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, linux.
- [amazon-ecs-cli](https://www.automicvault.com/pkg/brew/amazon-ecs-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.
- [ansible-builder](https://www.automicvault.com/pkg/brew/ansible-builder/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.
- [container](https://www.automicvault.com/pkg/brew/container/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, virtualization.
- [container-canary](https://www.automicvault.com/pkg/brew/container-canary/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.

## Combined YAML source

View the package source record on GitHub. [combined/incus.yml](https://github.com/automic-vault/db/blob/main/combined/incus.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
- external package-manager database matches
- cross-ecosystem install command graph
