# Distrobox changelog

> Run any Linux distribution inside your terminal via containers, tightly integrated with the host.

- Vendor: Luca Di Maio
- Category: Developer Tools
- Platforms: Linux
- Official site: https://distrobox.it
- Tracked by: What's New (https://whatsnew.fyi/product/distrobox)
- Harvested from: GitHub (89luca89/distrobox)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### 2.0.0-rc.4

- Date: 2026-07-25
- Version: 2.0.0-rc.4
- Original notes: https://github.com/89luca89/distrobox/releases/tag/2.0.0-rc.4
- Permalink: https://whatsnew.fyi/product/distrobox/releases/2.0.0-rc.4
- Labels: Pre-release; Platforms: Linux

- **fixed** — Replace --format json with backward-compatible alternatives
- **added** — Support both legacy and v2 in the install script
- **fixed** — Resolve --version flag conflict with --verbose/-v
- **fixed** — Ensure rootful containers add user to sudo/wheel group
- **fixed** — Check if group exists before appending user in init
- **fixed** — Do not consider scripts in PATH for inside-distrobox
- **fixed** — Parse distrobox flags after the container name in enter
- **changed** — Move the script dir resolution to the global config
- **fixed** — Resolve compatibility-matrix container setup failures in init
- **fixed** — Isolate NVIDIA libraries and fix Docker device groups for ROCm

##### What's Changed
* chore(deps): bump actions/setup-go from 6.4.0 to 6.5.0 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2146
* fix: replace --format json with backward-compatible alternatives by @dottorblaster in https://github.com/89luca89/distrobox/pull/2150
* feat(install): support both legacy and v2 in the install script by @dottorblaster in https://github.com/89luca89/distrobox/pull/2145
* fix: resolve --version flag conflict with --verbose/-v by @kairosci in https://github.com/89luca89/distrobox/pull/2157
* fix: ensure rootful containers add user to sudo/wheel group by @kairosci in https://github.com/89luca89/distrobox/pull/2158
* fix(init): check if group exists before appending user by @kairosci in https://github.com/89luca89/distrobox/pull/2162
* docs: update vanilla distrobox icon by @NN708 in https://github.com/89luca89/distrobox/pull/2164
* fix(inside-distrobox): do not consider scripts in PATH by @balanza in https://github.com/89luca89/distrobox/pull/2166
* fix(enter): parse distrobox flags after the container name by @89luca89 in https://github.com/89luca89/distrobox/pull/2165
* refactor(config): move the script dir resolution to the global config by @balanza in https://github.com/89luca89/distrobox/pull/2167
* refactor(cleanup): remove dead code and duplication by @89luca89 in https://github.com/89luca89/distrobox/pull/2172
* chore(license): add GPL-3.0 SPDX header to Go sources by @89luca89 in https://github.com/89luca89/distrobox/pull/2173
* fix(init): resolve compatibility-matrix container setup failures by @89luca89 in https://github.com/89luca89/distrobox/pull/2175
* fix(gpu): isolate NVIDIA libraries and fix Docker device groups for ROCm by @89luca89 in https://github.com/89luca89/distrobox/pull/2171

##### New Contributors
* @kairosci made their first contribution in https://github.com/89luca89/distrobox/pull/2157
* @NN708 made their first contribution in https://github.com/89luca89/distrobox/pull/2164

**Full Changelog**: https://github.com/89luca89/distrobox/compare/2.0.0-rc.3...2.0.0-rc.4

### 2.0.0-rc.3

- Date: 2026-06-29
- Version: 2.0.0-rc.3
- Original notes: https://github.com/89luca89/distrobox/releases/tag/2.0.0-rc.3
- Permalink: https://whatsnew.fyi/product/distrobox/releases/2.0.0-rc.3
- Labels: Pre-release; Platforms: Linux

- **fixed** — Fix the flags for read-only and recursive slave mount
- **fixed** — Replace remaining non-POSIX echo -e with printf in distrobox-init
- **added** — Add Fedora 44 distrobox
- **fixed** — Fix forbidigo on completion stdout writes
- **added** — Distrobox v2.0
- **changed** — Bump github.com/urfave/cli/v3 from 3.5.0 to 3.10.0
- **changed** — Bump gopkg.in/ini.v1 from 1.67.0 to 1.67.3
- **fixed** — Scope distrobox detection to known label keys in list
- **added** — Preserve v1 entry points after v2 single-binary split for compatibility

##### What's Changed
* docs: add docker.io/library/ubuntu:26.04 as a working container by @arungeorgesaji in https://github.com/89luca89/distrobox/pull/2076
* fix the flags for read-only and recursive slave mount by @capfredf in https://github.com/89luca89/distrobox/pull/2086
* docs: add columns parameter for better style packaging status by @Drsheppard01 in https://github.com/89luca89/distrobox/pull/2095
* fix(`distrobox-init`): Replace remaining non-POSIX `echo -e` with `printf` by @fiftydinar in https://github.com/89luca89/distrobox/pull/2114
* Add a Fedora 44 distrobox by @mbridon in https://github.com/89luca89/distrobox/pull/2120
* Fix/next cleanup by @89luca89 in https://github.com/89luca89/distrobox/pull/2133
* fix: forbidigo on completion stdout writes by @dottorblaster in https://github.com/89luca89/distrobox/pull/2134
* feat: distrobox v2.0 by @dottorblaster in https://github.com/89luca89/distrobox/pull/2122
* chore(deps): bump github.com/urfave/cli/v3 from 3.5.0 to 3.10.0 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2135
* chore(deps): bump actions/checkout from 6.0.2 to 7.0.0 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2137
* chore(deps): bump golangci/golangci-lint-action from 9.2.0 to 9.2.1 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2138
* chore(deps): bump gopkg.in/ini.v1 from 1.67.0 to 1.67.3 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2136
* fix(list): scope distrobox detection to known label keys by @89luca89 in https://github.com/89luca89/distrobox/pull/2143
* feat(compat): preserve v1 entry points after v2 single-binary split by @89luca89 in https://github.com/89luca89/distrobox/pull/2142
* chore(ci): bundle release by @balanza in https://github.com/89luca89/distrobox/pull/2141
* fix: release workflow when release tags already exist by @dottorblaster in https://github.com/89luca89/distrobox/pull/2144

##### New Contributors
* @Drsheppard01 made their first contribution in https://github.com/89luca89/distrobox/pull/2095
* @mbridon made their first contribution in https://github.com/89luca89/distrobox/pull/2120

**Full Changelog**: https://github.com/89luca89/distrobox/compare/1.8.2.5...2.0.0-rc.3

### 2.0.0-rc.2

- Date: 2026-04-30
- Version: 2.0.0-rc.2
- Original notes: https://github.com/89luca89/distrobox/releases/tag/2.0.0-rc.2
- Permalink: https://whatsnew.fyi/product/distrobox/releases/2.0.0-rc.2
- Labels: Pre-release; Platforms: Linux

- **added** — Add autodetect feature
- **added** — Make listing alphabetical
- **fixed** — Remove breaking spaces from exported desktop files
- **fixed** — Clean empty unversioned .so stubs during nvidia setup
- **fixed** — Execute correct binary for podman-launcher provider
- **fixed** — Fix unshare_groups su args and tty handling in enter command
- **fixed** — Pass root correctly to create and generate-entry command
- **fixed** — Propagate errors when entering containers
- **fixed** — Add MultiWriter to podman container manager
- **fixed** — Print container name on create when not provided
- **fixed** — Fix command args handling
- **fixed** — Handle root for each entry in assemble command
- **changed** — Load config as value object
- **changed** — Refactor tests with testify

##### What's Changed
* docs: port v2 announcements posts to branch next by @balanza in https://github.com/89luca89/distrobox/pull/2039
* fix: various bug fixes and code improvements by @mirkobrombin in https://github.com/89luca89/distrobox/pull/2047
* refactor: load config as value object by @balanza in https://github.com/89luca89/distrobox/pull/2041
* feat: autodetect by @fabriziosestito in https://github.com/89luca89/distrobox/pull/2046
* fix: remove breaking spaces exported desktop files by @simon-wg in https://github.com/89luca89/distrobox/pull/2051
* init: also clean empty unversioned .so stubs during nvidia setup by @edodusi in https://github.com/89luca89/distrobox/pull/2034
* fix(providers): execute correct binary for podman-launcher provider by @fabriziosestito in https://github.com/89luca89/distrobox/pull/2056
* refactor: tests with testify by @fabriziosestito in https://github.com/89luca89/distrobox/pull/2057
* fix(enter): unshare_groups su args and tty handling by @Aromatic05 in https://github.com/89luca89/distrobox/pull/2063
* ci: add commitlint by @fabriziosestito in https://github.com/89luca89/distrobox/pull/2064
* fix: passing root correctly to create and generate-entry command by @balanza in https://github.com/89luca89/distrobox/pull/2068
* fix(enter): propagate errors when entering containers by @Aromatic05 in https://github.com/89luca89/distrobox/pull/2070
* fix(containermanager): add MultiWriter to podman by @dottorblaster in https://github.com/89luca89/distrobox/pull/2073
* feat(list): make listing alphabetical by @arungeorgesaji in https://github.com/89luca89/distrobox/pull/2077
* fix: print container name on create when not provided by @balanza in https://github.com/89luca89/distrobox/pull/2082
* Fix/command args by @89luca89 in https://github.com/89luca89/distrobox/pull/2081
* fix(assemble): handle root for each entry  by @balanza in https://github.com/89luca89/distrobox/pull/2078

##### New Contributors
* @fabriziosestito made their first contribution in https://github.com/89luca89/distrobox/pull/2046
* @simon-wg made their first contribution in https://github.com/89luca89/distrobox/pull/2051

**Full Changelog**: https://github.com/89luca89/distrobox/compare/2.0.0-rc.1...2.0.0-rc.2

### 1.8.2.5

- Date: 2026-04-27
- Version: 1.8.2.5
- Original notes: https://github.com/89luca89/distrobox/releases/tag/1.8.2.5
- Permalink: https://whatsnew.fyi/product/distrobox/releases/1.8.2.5
- Labels: Platforms: Linux

- **changed** — Show container command on dry run
- **fixed** — Expose correct dryrun command
- **fixed** — Setup zypper use drop-in config file if possible
- **added** — Add ALT Linux compatibility improvements
- **fixed** — Pass -xdev to /bin/find
- **added** — Add Docker Desktop on macOS compatibility
- **fixed** — Chmod shadow files to 0400 for container storage compatibility
- **fixed** — Correct su argument order in unshare-groups path
- **fixed** — Clean empty unversioned .so stubs during nvidia setup

##### What's Changed
* docs: remove bluefin-cli and powershell ublue images by @renner0e in https://github.com/89luca89/distrobox/pull/1997
* docs: update documentation regarding VSCode integration by @ludrol in https://github.com/89luca89/distrobox/pull/1996
* enter: show container command on dry run by @balanza in https://github.com/89luca89/distrobox/pull/2000
* fix: expose correct dryrun command by @balanza in https://github.com/89luca89/distrobox/pull/2006
* fix: setup_zypper: use drop-in config file if possible by @dannyhpy in https://github.com/89luca89/distrobox/pull/2007
* docs: update README with sandboxing alternatives by @Gerharddc in https://github.com/89luca89/distrobox/pull/2009
* feat: add ALT Linux compatibility improvements by @liannnix in https://github.com/89luca89/distrobox/pull/1989
* fix: Pass -xdev to /bin/find by @danielzgtg in https://github.com/89luca89/distrobox/pull/1998
* add Docker Desktop on macOS compatibility by @ericcurtin in https://github.com/89luca89/distrobox/pull/2019
* init: chmod shadow files to 0400 for container storage compatibility by @89luca89 in https://github.com/89luca89/distrobox/pull/2020
* chore(ci): v2 release candidate workflow by @balanza in https://github.com/89luca89/distrobox/pull/2031
* docs(posts): announcing Distrobox v2 by @balanza in https://github.com/89luca89/distrobox/pull/2032
* build(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2045
* build(deps): bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2044
* build(deps): bump actions/download-artifact from 4 to 8 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2043
* build(deps): bump actions/setup-go from 5 to 6 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/2042
* docs: issue template notice for distrobox v2 by @balanza in https://github.com/89luca89/distrobox/pull/2049
* init: also clean empty unversioned .so stubs during nvidia setup by @edodusi in https://github.com/89luca89/distrobox/pull/2024
* fix(enter): su argument order in unshare_groups path (legacy) by @Aromatic05 in https://github.com/89luca89/distrobox/pull/2055
* fix(enter): correct order for su commands in unshare-groups by @dottorblaster in https://github.com/89luca89/distrobox/pull/2067
* chore: bump to v1.8.2.5 by @dottorblaster in https://github.com/89luca89/distrobox/pull/2072

##### New Contributors
* @ludrol made their first contribution in https://github.com/89luca89/distrobox/pull/1996
* @dannyhpy made their first contribution in https://github.com/89luca89/distrobox/pull/2007
* @Gerharddc made their first contribution in https://github.com/89luca89/distrobox/pull/2009
* @liannnix made their first contribution in https://github.com/89luca89/distrobox/pull/1989
* @danielzgtg made their first contribution in https://github.com/89luca89/distrobox/pull/1998

**Full Changelog**: https://github.com/89luca89/distrobox/compare/1.8.2.4...1.8.2.5

### 2.0.0-rc.1

- Date: 2026-03-29
- Version: 2.0.0-rc.1
- Original notes: https://github.com/89luca89/distrobox/releases/tag/2.0.0-rc.1
- Permalink: https://whatsnew.fyi/product/distrobox/releases/2.0.0-rc.1
- Labels: Pre-release; Platforms: Linux

- **added** — Add ALT Linux compatibility improvements
- **added** — Add Docker Desktop on macOS compatibility
- **changed** — Show container command on dry run in enter command
- **changed** — Update documentation regarding VSCode integration
- **changed** — Update README with sandboxing alternatives
- **changed** — Strip references to install scripts and add references to Makefile in documentation
- **fixed** — Expose correct dryrun command
- **fixed** — Setup zypper: use drop-in config file if possible
- **fixed** — Pass -xdev to /bin/find
- **fixed** — Chmod shadow files to 0400 for container storage compatibility

##### What's Changed
* docs: remove bluefin-cli and powershell ublue images by @renner0e in https://github.com/89luca89/distrobox/pull/1997
* docs: update documentation regarding VSCode integration by @ludrol in https://github.com/89luca89/distrobox/pull/1996
* enter: show container command on dry run by @balanza in https://github.com/89luca89/distrobox/pull/2000
* fix: expose correct dryrun command by @balanza in https://github.com/89luca89/distrobox/pull/2006
* fix: setup_zypper: use drop-in config file if possible by @dannyhpy in https://github.com/89luca89/distrobox/pull/2007
* docs: update README with sandboxing alternatives by @Gerharddc in https://github.com/89luca89/distrobox/pull/2009
* feat: add ALT Linux compatibility improvements by @liannnix in https://github.com/89luca89/distrobox/pull/1989
* fix: Pass -xdev to /bin/find by @danielzgtg in https://github.com/89luca89/distrobox/pull/1998
* add Docker Desktop on macOS compatibility by @ericcurtin in https://github.com/89luca89/distrobox/pull/2019
* init: chmod shadow files to 0400 for container storage compatibility by @89luca89 in https://github.com/89luca89/distrobox/pull/2020
* chore(ci): v2 release candidate workflow by @balanza in https://github.com/89luca89/distrobox/pull/2031
* docs: strip references to install scripts, add references to Makefile by @dottorblaster in https://github.com/89luca89/distrobox/pull/2029

##### New Contributors
* @ludrol made their first contribution in https://github.com/89luca89/distrobox/pull/1996
* @dannyhpy made their first contribution in https://github.com/89luca89/distrobox/pull/2007
* @Gerharddc made their first contribution in https://github.com/89luca89/distrobox/pull/2009
* @liannnix made their first contribution in https://github.com/89luca89/distrobox/pull/1989
* @danielzgtg made their first contribution in https://github.com/89luca89/distrobox/pull/1998

**Full Changelog**: https://github.com/89luca89/distrobox/compare/1.8.2.4...2.0.0-rc.1

### 1.8.2.4

- Date: 2026-02-04
- Version: 1.8.2.4
- Original notes: https://github.com/89luca89/distrobox/releases/tag/1.8.2.4
- Permalink: https://whatsnew.fyi/product/distrobox/releases/1.8.2.4
- Labels: Platforms: Linux

- **added** — Add missing dependencies for fedora and wolfi
- **changed** — Update Alpine Linux images to latest versions
- **fixed** — Add newline when appending user via printf in distrobox-init
- **changed** — Refactor user setup in init to modify attributes individually

##### What's Changed
* Add missing dependencies for fedora and wolfi. by @Kamorst in https://github.com/89luca89/distrobox/pull/1931
* docs: update Alpine Linux images to latest versions by @dottorblaster in https://github.com/89luca89/distrobox/pull/1977
* distrobox-init: add newline when appending user via printf by @tblume in https://github.com/89luca89/distrobox/pull/1988
* init: refactor user setup to modify attributes individually by @89luca89 in https://github.com/89luca89/distrobox/pull/1994
* chore(version): bump to v1.8.2.4 by @dottorblaster in https://github.com/89luca89/distrobox/pull/1995

##### New Contributors
* @tblume made their first contribution in https://github.com/89luca89/distrobox/pull/1988

**Full Changelog**: https://github.com/89luca89/distrobox/compare/1.8.2.3...1.8.2.4

### 1.8.2.3

- Date: 2026-01-17
- Version: 1.8.2.3
- Original notes: https://github.com/89luca89/distrobox/releases/tag/1.8.2.3
- Permalink: https://whatsnew.fyi/product/distrobox/releases/1.8.2.3
- Labels: Platforms: Linux

- **fixed** — Add missing Fedora dependency
- **fixed** — Remove unintended print to stdout in assemble command
- **fixed** — Ensure PWD matches workdir
- **fixed** — Fix support for newer shadow stricter checks
- **changed** — Install base packages only once
- **fixed** — Remove error in case dependencies are not fully met
- **fixed** — Fix manpages generation auth error

##### What's Changed
* fix: add missing fedora dependency by @Kamorst in https://github.com/89luca89/distrobox/pull/1922
* fix: unintended print to stdout in assemble command by @balanza in https://github.com/89luca89/distrobox/pull/1925
* build(deps): bump actions/checkout from 5 to 6 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/1929
* Review README.md by @nilslindemann in https://github.com/89luca89/distrobox/pull/1953
* fix: make sure PWD matches workdir by @Taywee in https://github.com/89luca89/distrobox/pull/1952
* fix(init): fix support for newer shadow strictier checks by @89luca89 in https://github.com/89luca89/distrobox/pull/1965
* init: only install base packages once by @Kamorst in https://github.com/89luca89/distrobox/pull/1932
* fix: remove the error in case dependencies are not fully met by @dottorblaster in https://github.com/89luca89/distrobox/pull/1967
* fix: manpages generation auth error by @dottorblaster in https://github.com/89luca89/distrobox/pull/1968
* chore(version): bump to 1.8.2.3 by @dottorblaster in https://github.com/89luca89/distrobox/pull/1969
* docs: add Fedora 43 to the compatbility list by @dottorblaster in https://github.com/89luca89/distrobox/pull/1970
* docs: fix manpages generation by setting contents: write permissions by @dottorblaster in https://github.com/89luca89/distrobox/pull/1971
* docs: add CentOS Stream 10 to the supported container OSes by @dottorblaster in https://github.com/89luca89/distrobox/pull/1972
* ci: persist credentials in order to allow for manpages commit by @dottorblaster in https://github.com/89luca89/distrobox/pull/1973
* docs: add Oracle Linux 10 to the compatibility doc by @dottorblaster in https://github.com/89luca89/distrobox/pull/1974
* docs: leverage PAT again for gen_man action by @dottorblaster in https://github.com/89luca89/distrobox/pull/1975
* docs: add Linux Mint 22.3 to the compatibility document by @dottorblaster in https://github.com/89luca89/distrobox/pull/1976

##### New Contributors
* @nilslindemann made their first contribution in https://github.com/89luca89/distrobox/pull/1953
* @Taywee made their first contribution in https://github.com/89luca89/distrobox/pull/1952

**Full Changelog**: https://github.com/89luca89/distrobox/compare/1.8.2.2...1.8.2.3

### 1.8.2.2

- Date: 2025-11-26
- Version: 1.8.2.2
- Original notes: https://github.com/89luca89/distrobox/releases/tag/1.8.2.2
- Permalink: https://whatsnew.fyi/product/distrobox/releases/1.8.2.2
- Labels: Platforms: Linux

- **fixed** — Fix stat syntax error in rootful detection
- **fixed** — Fix failing to create containers from images that print to stdout with no input
- **fixed** — Restrict find pattern to libcuda so it doesn't pick up non-NVIDIA libs
- **fixed** — Direct stderr to /dev/null to prevent incorrect eval
- **fixed** — Don't use --pty with buggy su implementations
- **added** — Set compopt filenames for --file in bash completion
- **changed** — Preserve SHELL with unshared groups
- **changed** — Add /dev/null stdin for distrobox enter execs

##### What's Changed
* docs: update command for GNOME installation by @amnexya in https://github.com/89luca89/distrobox/pull/1873
* Fix typo in nested Podman instructions by @atimeofday in https://github.com/89luca89/distrobox/pull/1879
* docs: note that Podman and Distrobox are now pre-installed on SteamOS 3.5+ by @kavishgr in https://github.com/89luca89/distrobox/pull/1881
* docs: clarify distrobox-host-exec behavior by @jaluoma in https://github.com/89luca89/distrobox/pull/1882
* docs: fix reference to #28 in README.md by @dottorblaster in https://github.com/89luca89/distrobox/pull/1891
* init: fix stat syntax error in rootful detection by @john-holt4 in https://github.com/89luca89/distrobox/pull/1907
* docs: fix mdlint issues in compatibility matrix by @dottorblaster in https://github.com/89luca89/distrobox/pull/1908
* create: fix failing to create containers from images that print to stdout with no input by @bsutherland333 in https://github.com/89luca89/distrobox/pull/1912
* docs: systemd unit example to mount root as a shared mount by @yehorb in https://github.com/89luca89/distrobox/pull/1911
* assemble: /dev/null stdin for distrobox enter execs by @dottorblaster and @balanza in https://github.com/89luca89/distrobox/pull/1915
* feat: set compopt filenames for --file in bash completion by @yedayak in https://github.com/89luca89/distrobox/pull/1916
* enter: preserve SHELL with unshared groups by @Kamorst in https://github.com/89luca89/distrobox/pull/1917
* fix: don't use --pty with buggy su implementations by @Kamorst in https://github.com/89luca89/distrobox/pull/1919
* init: restrict find pattern to libcuda so it doesn't pick up non-NVIDIA libs by @miaulightouch in https://github.com/89luca89/distrobox/pull/1918
* create: direct stderr to /dev/null to prevent incorrect eval by @dottorblaster and @inc0 in https://github.com/89luca89/distrobox/pull/1920
* chore(version): bump to 1.8.2.2 by @dottorblaster in https://github.com/89luca89/distrobox/pull/1921

##### New Contributors
* @amnexya made their first contribution in https://github.com/89luca89/distrobox/pull/1873
* @atimeofday made their first contribution in https://github.com/89luca89/distrobox/pull/1879
* @kavishgr made their first contribution in https://github.com/89luca89/distrobox/pull/1881
* @jaluoma made their first contribution in https://github.com/89luca89/distrobox/pull/1882
* @john-holt4 made their first contribution in https://github.com/89luca89/distrobox/pull/1907
* @bsutherland333 made their first contribution in https://github.com/89luca89/distrobox/pull/1912
* @yehorb made their first contribution in https://github.com/89luca89/distrobox/pull/1911
* @yedayak made their first contribution in https://github.com/89luca89/distrobox/pull/1916
* @miaulightouch made their first contribution in https://github.com/89luca89/distrobox/pull/1918

**Full Changelog**: https://github.com/89luca89/distrobox/compare/1.8.2.1...1.8.2.2

### 1.8.2.1

- Date: 2025-11-06
- Version: 1.8.2.1
- Original notes: https://github.com/89luca89/distrobox/releases/tag/1.8.2.1
- Permalink: https://whatsnew.fyi/product/distrobox/releases/1.8.2.1
- Labels: Platforms: Linux

- **fixed** — Fix Alt environment variable case to ALT
- **fixed** — Fix wrong $HOME when using --init

##### What's Changed
* fix: `Alt` -> `ALT` by @x1z53 in https://github.com/89luca89/distrobox/pull/1868
* build(deps): bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in https://github.com/89luca89/distrobox/pull/1869
* init: fix wrong $HOME when using --init by @Kamorst in https://github.com/89luca89/distrobox/pull/1871
* chore: bump version to 1.8.2.1 by @dottorblaster in https://github.com/89luca89/distrobox/pull/1872

##### New Contributors
* @x1z53 made their first contribution in https://github.com/89luca89/distrobox/pull/1868

**Full Changelog**: https://github.com/89luca89/distrobox/compare/1.8.2.0...1.8.2.1

### 1.8.2.0

- Date: 2025-10-28
- Version: 1.8.2.0
- Original notes: https://github.com/89luca89/distrobox/releases/tag/1.8.2.0
- Permalink: https://whatsnew.fyi/product/distrobox/releases/1.8.2.0
- Labels: Platforms: Linux

- **removed** — Decommission Clearlinux
- **added** — Add unshare-groups support to assemble
- **added** — Extend manifest definitions with include in assemble
- **fixed** — Fix accidental file globbing during parsing in assemble
- **added** — Support --userns=keep-id:size= in create
- **changed** — Explicitly prefer using crun if present in create
- **fixed** — Fix formatting and quoting issues in create
- **added** — Bash completion enhancements
- **fixed** — Allow whitespaces in environment variables in enter
- **fixed** — Fix doas case and missing sudo_prefix when local execution in export
- **fixed** — Fail for HTTP response codes >= 400 in host-exec
- **added** — Support Chimera Linux guests in init
- **fixed** — Fix Vulkan ICD config files for NVIDIA driver host integration in init
- **added** — Add altlinux support in distrobox
- **fixed** — Create xdg-open distrobox-host-exec symlink only if --init not used in init
- **changed** — Exclude schroot mountpoint from socket search and improve performance in init
- **fixed** — Fix missing sudo binary on doas distro and make export aware of it
- **fixed** — Fix on systemd to not do remount in containers
- **fixed** — Fix passwordless doas
- **added** — Add option to suppress color in install
- **fixed** — Fix upgrade command when on doas systems

After some time a much needed release!
lots of fixes and polishing all over the place! Thanks @dottorblaster for
stepping in and welcome him as a new part of the maintainer team!

And thank you to 20 new first time contributors!

Please be ware that there was a little change with the telegram group, so if
you're on the old channel, please abandon that and change to the new one on https://t.me/distrobox_chat_new

##### What's Changed
* all: decommission Clearlinux
* assemble: add unshare-groups support by @PoQuatre in https://github.com/89luca89/distrobox/pull/1675
* assemble: extend manifest definitions with include by @balanza in https://github.com/89luca89/distrobox/pull/1860
* assemble: fix accidental file globbing during parsing by @jeffmahoney in https://github.com/89luca89/distrobox/pull/1713
* ci: ignore Neon and SteamOS when testing images by @dottorblaster in https://github.com/89luca89/distrobox/pull/1817
* completion: Bash completion enhancements by @Kamorst in https://github.com/89luca89/distrobox/pull/1848
* create: Support --userns=keep-id:size= by @Jookia in https://github.com/89luca89/distrobox/pull/1667
* create: explicitly prefer using crun if present
* create: fix formatting and quoting issues by @dottorblaster in https://github.com/89luca89/distrobox/pull/1862
* create: indentation for --root usage in distrobox-create by @apollo7321 in https://github.com/89luca89/distrobox/pull/1846
* docs: Add Hyprland setup instructions to Distrobox guide by @AbduEhab in https://github.com/89luca89/distrobox/pull/1833
* docs: Fix a small documentation typo s/you/your/ by @davetha in https://github.com/89luca89/distrobox/pull/1748
* docs: Fix broken Useful tips link by @brandondong in https://github.com/89luca89/distrobox/pull/1721
* docs: Include hostname flag in distrobox-assemble docs, resolve #1851 by @xaque in https://github.com/89luca89/distrobox/pull/1853
* docs: Remove --name argument from distrobox-stop usage docs by @brennenputh in https://github.com/89luca89/distrobox/pull/1807
* docs: add CentOS Stream 10 to the compatibile distros by @dottorblaster in https://github.com/89luca89/distrobox/pull/1822
* docs: add debian 13 (toolbox) to the manual by @dottorblaster in https://github.com/89luca89/distrobox/pull/1820
* docs: add distrobox-bpftrace openSUSE's image to the docs by @dottorblaster in https://github.com/89luca89/distrobox/pull/1715
* docs: clarify --root documentation for distrobox-create by @apollo7321 in https://github.com/89luca89/distrobox/pull/1845
* docs: fedora 42 by @dottorblaster in https://github.com/89luca89/distrobox/pull/1819
* docs: fix markdown lint by @dottorblaster in https://github.com/89luca89/distrobox/pull/1815
* docs: fix steamdeck guide
* docs: fix ublue arch URL by @renner0e in https://github.com/89luca89/distrobox/pull/1753
* docs: move to new telegram channel
* docs: refactor: replace "Silverblue" with "Atomic Desktops" by @boredsquirrel in https://github.com/89luca89/distrobox/pull/1679
* docs: update supported Debian images according to post-13 EOL data by @dottorblaster in https://github.com/89luca89/distrobox/pull/1816
* docs: update tips for cross-platform images, Fix #1669
* docs: update tips for using custom SHELL in assemble, Fix #1633 by @koldle in https://github.com/89luca89/distrobox/pull/1825
* docs: update_steamdeck_guide.md by @victoraalm in https://github.com/89luca89/distrobox/pull/1587
* enter: Allow whitespaces in environment variables by @scosu in https://github.com/89luca89/distrobox/pull/1811
* export: fix doas case, fix missing sudo_prefix when local execution
* host-exec: fail for HTTP response codes >= 400 (curl --fail) by @peppergrayxyz in https://github.com/89luca89/distrobox/pull/1787
* init: Support Chimera Linux guests by @JamiKettunen in https://github.com/89luca89/distrobox/pull/1778
* init: [#1687] Fixes Vulkan ICD config files for NVIDIA driver host integration (openSUSE, Fedora) by @m4nn in https://gith

_[Truncated at 4000 characters — full notes: https://github.com/89luca89/distrobox/releases/tag/1.8.2.0]_