Commit Graph
452 Commits
Author SHA1 Message Date
Luca Di Maio 9c2ba30891 fix(docs): remove broken distro from compatibility list
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2026-07-25 11:32:38 +02:00
NN708 427a626fa7 docs: update vanilla distrobox icon 2026-07-17 11:26:47 +02:00
Alessio Biancalana fdfb4a1d0e feat(install): support both legacy and v2 in the install script (#2145) 2026-07-06 08:22:22 +02:00
Luca Di Maio 8d96cce479 docs: switch usage and man pages to v2 subcommand syntax
Rewrite distrobox-*.md to `distrobox <cmd>`, reconcile flag tables with
internal/cli, refresh README+useful_tips, regenerate man/man1/*.1.

Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2026-06-25 13:39:47 +02:00
Luca Di Maio 6328b71aa4 docs: clarify go rewrite use of config file
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2026-06-25 09:07:20 +02:00
Alessio Biancalana 9d4955a23e docs: strip references to install scripts, add references to Makefile (#2029)
Signed-off-by: Alessio Biancalana <alessio@dottorblaster.it>
2026-06-14 13:04:28 +02:00
bochechaandMathieu Bridon bb97275aa4 docs: add Fedora 44 to supported images (#2120)
Taken from quay.io as were the other ones.

Co-authored-by: Mathieu Bridon <bochecha@daitauha.fr>
2026-05-27 15:18:50 +02:00
DrSheppard 1345aff08e docs: add columns parameter for better style packaging status (#2095)
[Docs] Add columns parameter for better style packaging status
2026-05-09 11:28:09 +02:00
LinuxJourney 12fa480b65 docs: add docker.io/library/ubuntu:26.04 as a working container (#2076) 2026-04-28 08:41:46 +02:00
Luca Di Maio cbf6a99ff6 Fix DOCS links
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2026-03-30 15:57:55 +02:00
6155b5e33e docs(posts): announcing Distrobox v2 (#2032)
* docs(posts): announcing v2 post

Co-authored-by: 89luca89 <luca.dimaio1@gmail.com>
Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>
Co-authored-by: Fabrizio Sestito <fabrizio.sestito@suse.com>

* docs(posts): distrobox next architecture

Co-authored-by: 89luca89 <luca.dimaio1@gmail.com>
Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>
Co-authored-by: Fabrizio Sestito <fabrizio.sestito@suse.com>

* docs: fix link to distrobox next architecture

---------

Co-authored-by: 89luca89 <luca.dimaio1@gmail.com>
Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>
Co-authored-by: Fabrizio Sestito <fabrizio.sestito@suse.com>
2026-03-29 18:47:14 +02:00
Eric Curtin 4e3dbe5b9a all: add Docker Desktop on macOS compatibility (#2019)
On macOS, Docker Desktop mounts all paths as private (rprivate) in its
Linux VM via VirtioFS, so rslave/rshared bind propagation is rejected.
Strip these propagation options from the generated docker create command
when running on Darwin.

Also fix a bug in distrobox-init where the socket path prefix stripping
used `sed 's|/run/host||g'` with the global flag, causing paths like
`/run/host/run/host-services/ssh-auth.sock` (a Docker Desktop socket)
to be mangled into `-services/ssh-auth.sock`. The leading `-` was then
parsed as a flag by `rm`, crashing the init script. Replace with shell
parameter expansion `${host_socket#/run/host}` which strips the prefix
exactly once.

distrobox-init detects "rootful" mode by checking if /run/host/etc/shadow
is accessible and owned by root. On macOS with Docker Desktop, all containers
run as root inside the Linux VM, so this check always succeeds even for
containers created without --root, causing a spurious first-shell password
prompt.

Fix this by having distrobox-create mount /dev/null:/run/.distrobox.rootless:ro
for every rootless container. distrobox-init now checks for this marker first
and skips the shadow heuristic when it is present.

This is backward-compatible: existing containers without the marker continue
to use the shadow-file heuristic as before.

Signed-off-by: Eric Curtin <eric.curtin@docker.com>
2026-03-19 11:53:26 +01:00
Gerhard de ClercqandAlessio Biancalana 4f86c35af7 docs: update README with sandboxing alternatives (#2009)
* Update README with sandboxing alternatives

Added information about alternatives to Distrobox with sandboxing capabilities.

* Fix docs/README.md typo

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>

---------

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>
2026-02-27 17:50:53 +01:00
ludrolandAlessio Biancalana 82ee78ee83 docs: update documentation regarding VSCode integration (#1996)
* docs: update VSCode integration documentation
There are still some problems but it's the best I could test on my own

* docs: added a screenshot to better illustrate the process

* chore: fix lint errors

* fix: typo

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>

* fix: typo

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>

* fix: typo

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>

---------

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>
2026-02-10 10:44:26 +01:00
renner 3d8159ec19 docs: remove bluefin-cli and powershell ublue images (#1997)
See:
https://github.com/ublue-os/toolboxes/pull/546
https://github.com/ublue-os/toolboxes/pull/547
2026-02-10 10:02:33 +01:00
Alessio Biancalana 0316d24765 docs: update Alpine Linux images to latest versions (#1977) 2026-01-18 01:38:57 +01:00
Alessio Biancalana b91cf8cea9 docs: add Linux Mint 22.3 to the compatibility document (#1976) 2026-01-17 09:51:27 +01:00
Alessio Biancalana c220794f8c docs: add Oracle Linux 10 to the compatibility doc (#1974) 2026-01-17 09:37:47 +01:00
Alessio Biancalana 70112dd93a docs: add CentOS Stream 10 to the supported container OSes (#1972) 2026-01-17 09:21:22 +01:00
Alessio Biancalana 41b79b5e75 docs: add Fedora 43 to the compatbility list (#1970) 2026-01-17 08:58:30 +01:00
Nils-Hero Lindemann ecbf27e880 chore: readme review (#1953)
Corrected grammar and punctuation in README.md.
2026-01-06 11:18:51 +01:00
Yehor Borkov 45cb136cbc docs: systemd unit example to mount root as a shared mount (#1911)
* docs: provide systemd service unit example to mount root as a shared mount

* fix: typo

* fix: make markdownlint happy
2025-11-22 16:26:29 +01:00
Alessio Biancalana 99b7df4b77 docs: fix mdlint issues in compatibility matrix (#1908) 2025-11-19 16:10:02 +01:00
Alessio Biancalana 7c31a05b36 docs: fix reference to #28 in README.md (#1891) 2025-11-18 09:12:14 +01:00
Jukka Luoma e290d63e76 docs: clarify distrobox-host-exec behavior (#1882)
The usage documentation was unclear about how distrobox-host-exec behaves
when it is not given an argument and when it is called via a symlink.
This commit adds some text and examples to clarify things.
2025-11-14 16:53:21 +01:00
Kavish Gour 6c308d5192 Update SteamOS compatibility details (#1881)
Updated SteamOS compatibility information to reflect that Podman and Distrobox are pre-installed starting with SteamOS 3.5.
2025-11-14 08:58:04 +01:00
Ian Off 6fb167ceee docs: fix typo in nested Podman instructions (#1879)
Corrected a typo in the instructions for using Podman inside a Distrobox.
2025-11-11 09:00:53 +01:00
amnexya 9bdda6a4d2 docs: update command for GNOME installation (#1873) 2025-11-07 00:14:13 +01:00
Sultaniiazov David faa95791a5 fix: Alt -> ALT (#1868) 2025-10-31 14:07:33 +01:00
Emanuele De CupisandAlessio Biancalana 4c3895f4e8 feat: extend manifest definitions with include (#1860)
* implement manifest include resolution

* Update docs/usage/distrobox-assemble.md

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>

---------

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>
2025-10-27 15:19:34 +01:00
Luca Di Maio 1d88f8cc06 docs: move to new telegram channel
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2025-10-26 10:24:53 +01:00
Zack 9f4c085be6 docs: include hostname flag in distrobox-assemble docs, resolve #1851 (#1853) 2025-10-10 09:00:01 +02:00
Abdelrahman Ehab 159acc0860 docs: add Hyprland setup instructions to Distrobox guide (#1833)
* Add Hyprland setup instructions to Distrobox guide

Added instructions for running the latest Hyprland session in Distrobox, including container creation and environment variable setup. I did not add any images, as I am unsure if they are needed.

* fixed lint issues

* Update link to include Hyprland in documentation
2025-09-16 18:49:47 +02:00
Coldle 3ad9ef0dc8 docs: update tips for using custom SHELL in assemble, Fix #1633 (#1825) 2025-08-24 15:46:32 +02:00
Luca Di Maio 19861f95f3 all: decommission Clearlinux
Intel has discontinued the distribution, so we remove it from the
compatibility list, and the `swupd` package manager support

Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2025-08-24 13:38:57 +02:00
Luca Di Maio 7f5bf65e94 docs: fix steamdeck guide
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2025-08-24 13:28:13 +02:00
Luca Di Maio 5fec9c1a27 docs: update tips for cross-platform images, Fix #1669
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2025-08-24 12:45:56 +02:00
Jami Kettunen f36ccd7720 init: support Chimera Linux guests (#1778)
* init: properly support Chimera Linux guests

https://chimera-linux.org

* init: add some basic doas(1) support

This is an alternative to sudo(1) originating from OpenBSD and also
ported to Linux; base configuration on Chimera Linux where this will be
used.

* init: also support FreeBSD-style stat(1) syntax for rootful check

These system utils are largely used on Chimera Linux (as chimerautils):
  + stat -c %u /run/host/etc/shadow
  stat: unrecognized option: c
  usage: stat [-FLnq] [-f format | -l | -r | -s | -x] [-t timefmt] [file|handle ...]

* docs: Chimera Linux compatability tested as host and guest
2025-08-24 12:22:30 +02:00
511eed81d0 docs: replace "Silverblue" with "Atomic Desktops" (#1679)
* docs: replace "Silverblue" with "Atomic Desktops"

Fedora Atomic Desktops is the name for all of the variants, Silverblue is just the GNOME one

Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>

---------

Co-authored-by: Luca Di Maio <luca.dimaio1@gmail.com>
Co-authored-by: Alessio Biancalana <alessio@dottorblaster.it>
2025-08-24 11:51:13 +02:00
Victor Alves do Amaral Leme MatiasandLuca Di Maio 10d7e1e655 docs: update steamdeck_guide.md (#1587)
Install Distrobox and Podman PERMANENT  on SteamOS >= 3.5

Co-authored-by: Luca Di Maio <luca.dimaio1@gmail.com>
2025-08-24 11:49:42 +02:00
Alessio Biancalana 9ca813da54 docs: add CentOS Stream 10 to the compatibile distros (#1822) 2025-08-24 11:23:58 +02:00
Alessio Biancalana 32fb2491ac docs: add debian 13 (toolbox) to the manual (#1820) 2025-08-22 14:45:38 +02:00
Alessio Biancalana f9f16bba8c docs: add Fedora 42 to tested Fedora images (#1819) 2025-08-21 15:47:51 +02:00
Vladislav c0e03f23cf feat: add ALT Linux support (#1512) 2025-08-21 15:07:17 +02:00
Matéo LE FLEM 07b3abf201 assemble: add unshare-groups support (#1675) 2025-08-21 12:02:37 +02:00
Alessio Biancalana d47e93de0b docs: update supported Debian images according to post-13 EOL data (#1816)
* docs: update debian compatibility according to current Debian's EOL info

* docs: Debian 10 Toolbox is now EOL
2025-08-20 19:20:20 +02:00
rennerandFlori Gee 63e69bd4b8 docs: fix ublue arch URL (#1753)
See: https://github.com/ublue-os/toolboxes/pull/141

Co-authored-by: Flori Gee <renner03@protonmail.com>
2025-08-19 19:56:30 +02:00
Alessio Biancalana 1a513a914d docs: fix markdown lint (#1815)
* docs: add MD025 and MD059 to disabled linting rules

* chore: fix markdown for bug report template

* docs: ignore linting for a very specific, tricky doc link
2025-08-19 19:23:28 +02:00
David 1bafb4f1a3 docs: fix small typo in that docs that was making it not go to the correct document block (#1748) 2025-08-19 18:10:40 +02:00
Alessio Biancalana 4994268129 docs: add distrobox-bpftrace openSUSE's image to the docs (#1715)
Thanks <3
2025-04-30 10:29:46 +02:00