Commit Graph

52 Commits

Author SHA1 Message Date
Brian Di Palma
24a008f83f docs: update useful_tips.md to add note on copying to host clipboard (#1225)
* Update useful_tips.md to add note on copying to host clipboard

* fix linting

---------

Co-authored-by: Luca Di Maio <luca.dimaio1@gmail.com>
2024-02-22 10:58:55 +01:00
Sandorex
d26a926ff7 create: add --hostname argument and DBX_CONTAINER_HOSTNAME env var (#1214)
* Add --hostname argument and DBX_CONTAINER_HOSTNAME env var

* Update usage/distrobox-create.md and useful_tips.md

* Refining error message when hostname is too long
2024-02-18 18:08:36 +01:00
Michael Haaf
0a9f8aa8bc docs: fix init-hoot script for hostname matching (#1182)
The init-hook provided for creating a distrobox with the
the same hostname as its host has two typos:

- Command substitution wrapping `uname -n` suppressing stdout redirect
- trailing "`"

Using this init-hook as suggested causes build errors.
This fix corrects the suggested script by echoing the command
substitution and removing the trailing "`".

See issue #1164 for details.
2024-02-15 16:30:34 +01:00
Osama Albahrani
2f0968d47c all: Bump default container image to Fedora 39 (#1134)
Best-effort, search-and-replace. Checked manually using:

    % rg -iC1 'fedora.*38'

Fedora 39 was released 2023-11-07 (about 2 months ago)

imho, 2 months is enough of a grace period. Thoughts?

- Fixes 89luca89/distrobox#1119
2024-02-01 22:34:23 +01:00
Luca Di Maio
6ee5467469 docs: update container save/restore, Fix #1015
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-11-19 15:36:40 +01:00
Luca Di Maio
c831e2e46d docs: document incompatibility with VirtualBox, Fix #910
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-09-25 00:25:33 +02:00
Luca Di Maio
1686879412 docs: add new Steamdeck guide, document setup and workarounds for Pipewire audio. Fix #960
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-09-12 07:03:36 +00:00
Alex
d3ab272546 docs: update useful_tips.md (#954)
Fix typo.
2023-09-05 09:20:33 +02:00
Mirko Brombin
9326ac17c9 docs: document how to run Waydroid inside distrobox (#951) 2023-09-02 10:49:16 +02:00
Luca Di Maio
ddecc876ce docs: update useful_tips.md 2023-08-30 20:55:37 +02:00
Luca Di Maio
2a40be3ad8 docs: add preview for initful systems 2023-08-27 23:56:35 +02:00
Luca Di Maio
981ccce78a docs: fix formatting
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-08-27 21:53:06 +00:00
Luca Di Maio
c00fd4f9fd docs: document how to get nested Docker, Podman and LXC inside a Distrobox container
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-08-26 20:17:10 +00:00
Luca Di Maio
0c4615b308 init: better handle dependency detection, better support OpenRC for initful containers, better document in man pages how to create initful containers
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-08-26 12:15:59 +00:00
Scott Bronson
13444ef628 docs: format code example properly (#925)
As written previously, Markdown would join the two lines into a one-line paragraph and show an invalid command.
2023-08-18 23:52:26 +02:00
Luca Di Maio
eb1d9d8193 docs: document the use of --init with --additional-packages for non-premade systemd images
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-06-15 18:33:46 +02:00
Luca Di Maio
463f7bc237 Update Docs
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-06-13 22:41:59 +02:00
Luca Di Maio
8178a543e1 docs: update docs page
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-05-02 22:41:11 +02:00
Luca Di Maio
efd9a293ee init: add nvidia integration (#658)
* init: add nvidia integration

This is a preliminary work to implement host's nVidia driver's
integration, in the guest.

The procedure is simple enough, it will try and find all nVidia related
files in the host, and bind mount them in the guest.

---------

Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
Signed-off-by: Dario Faggioli <dfaggioli@suse.com>
Co-authored-by:: Luca Di Maio <luca.dimaio1@gmail.com>
Co-authored-by: Dario Faggioli <dfaggioli@suse.com>
Co-authored-by:  Michael Lingelbach <m.j.lbach@gmail.com>
2023-03-26 16:00:21 +02:00
Kian-Meng Ang
107503a20b docs: fix typos (#662)
Found via `codespell -L bu,te`
2023-03-19 08:53:56 +01:00
Luca Di Maio
cc53128ba8 docs: add example of using pre-init-hooks to configure an Apt system behind proxy. Fix #631
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-03-09 20:17:39 +01:00
Luca Di Maio
3bea7bd0a2 docs: reword a bit the rootful distrobox suggestions
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2023-02-10 17:11:26 +01:00
Luciano Santos
96d3b219a8 all: allow root user to run Distrobox (#582)
Up until now, we were unable to distinguish between normal users
(running the scripts via sudo) and root user (running the script in a
login shell). This introduces a check for the SUDO_USER and DOAS_USER
variables (created in unmodified environments, by sudo and doas,
respectively), among other mechanisms, to allow the root user to manage
rootful containers.

Fixes #575

Signed-off-by: Luciano Santos <luc14n0@opensuse.org>
2023-02-10 17:07:28 +01:00
Luca Di Maio
a1be45d274 docs: add post - Run libvirt in distrobox
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-12-19 15:16:24 +01:00
Luca Di Maio
60e19b2786 docs: update documentation to use host-exec for podman/docker inside the container. Fix #494
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-12-05 17:03:34 +01:00
thjderjktyrjkt
3a4aac8db6 docs: add resource limitation tips (#515)
* Update useful_tips.md

Co-authored-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-11-22 00:06:15 +01:00
Luca Di Maio
cedff849a2 enter/export: handle quotes in arguments in a better way (#448)
* enter/export: handle quotes in arguments in a better way

This enables the use of spaced arguments, quotes and special chars
handling in both enter and export

Fix #439

Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-10-19 19:37:28 +02:00
Luca Di Maio
819b782a1c init: use findmnt instead of mountpoint, fixing compatibility with old distributions. Fix #370
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-09-30 18:28:40 +02:00
Mišo Barišić
20ee5f246c docs: mention other commands in readme, fix typo in useful_tips.md (#421)
Signed-off-by: Mišo Barišić <me@misobarisic.com>
2022-09-21 15:02:41 +02:00
Michel Alexandre Salim
17d3eb624c docs: update host and guest lists (#410)
Host:
- distrobox for Debian is in testing
- update Ubuntu versions

Guest:
- Rocky 9 is available
- update useful_tips.md examples for pre-init-hooks

Signed-off-by: Michel Alexandre Salim <michel@michel-slm.name>
2022-09-13 10:05:30 +02:00
Luca Di Maio
0e5acdd61f all: bump version to 1.4.0
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-09-07 12:29:56 +02:00
Luca Di Maio
22a0b78476 generate-entry: add new command to create and delete desktop entries for distroboxes
This utility is automatically called by create and rm, so newer
distroboxes created with this version onward will automatically be added
to you applications list.
This tool can also be called separately to create/recreate/remove an
entry.

Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-08-28 19:15:18 +02:00
Luca Di Maio
e395458d67 enter: use container's login shell when no command is provided
This will make it easier to have containers with different login shell
than the host, and will make it easier to fallback to working shells if
init fails to install the host's custom shell.

Fix #377

Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-08-28 17:29:06 +02:00
Pg Biel
8f34b9d26e all: oiplement options for sudo program customization (#346) 2022-07-10 22:24:50 +02:00
Luca Di Maio
ec4928b8b4 docs: add entry on how to use qemu to use containers of different architectures
Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-05-28 19:53:09 +02:00
Michel Alexandre Salim
b68492661c docs: Add AlmaLinux 9 to tested containers distros (#280)
Tested and worked fine. I had to install `dnf-plugins-core` which is
installed out of the box on AlmaLinux 8, but that's not a distrobox
issue.

```shell
distrobox on  main
❯ ./distrobox create -i docker.io/library/almalinux:9 -n alma9 --pre-init-hooks "dnf -y install dnf-plugins-core && dnf config-manager --enable crb && dnf -y install epel-release"
39a00b6fdacdbd22217fba9ff9c08a2468c8a57747f0df6e501ff057231899eb
Distrobox 'alma9' successfully created.
To enter, run:

distrobox-enter alma9

distrobox on  main
❯ ./distrobox enter alma9
Container alma9 is not running.
Starting container alma9
run this command to follow along:

 podman logs -f alma9

 Starting container...                  	[ OK ]
 Executing pre-init hooks...            	[ OK ]
 Installing basic packages...           	[ OK ]
 Setting up read-only mounts...         	[ OK ]
 Setting up read-write mounts...        	[ OK ]
 Setting up host's sockets integration...	[ OK ]
 Integrating host's themes, icons, fonts...	[ OK ]
 Setting up package manager exceptions...	[ OK ]
 Setting up sudo...                     	[ OK ]
 Setting up groups...                   	[ OK ]
 Setting up users...                    	[ OK ]
 Executing init hooks...                	[ OK ]

Container Setup Complete!
Welcome to fish, the friendly interactive shell
Type help for instructions on how to use fish

distrobox on  main
⬢ [almalinux:9] ❯
```

Signed-off-by: Michel Alexandre Salim <michel@michel-slm.name>
2022-05-18 02:01:01 +02:00
Michel Alexandre Salim
62dd2fda8f init: Implement pre-initialization hooks (#269)
* Implement pre-initialization hooks

This implements support for running commands prior to most of the
container initialization. e.g. for RHEL and derivatives you might need
to pre-enable the PowerTools/CRB and EPEL repositories.

Resolves: #220

```
distrobox on  main [!⇡]
✦ ❯ ./distrobox create -i registry.fedoraproject.org/fedora-toolbox:36 f36-packaging
a3cc54e5a820b6bd95286ec142cb3eeab7f72b42cebf6fa0d3c0072035b3bca4
Distrobox 'f36-packaging' successfully created.
To enter, run:

distrobox-enter f36-packaging

distrobox on  main [!⇡]
✦ ❯ ./distrobox enter f36-packaging
Container f36-packaging is not runnung.
Starting container f36-packaging
run this command to follow along:

 podman logs -f f36-packaging

 Starting container...                  	 [ OK ]
 Installing basic packages...           	 [ OK ]
 Setting up read-only mounts...         	 [ OK ]
 Setting up read-write mounts...        	 [ OK ]
 Setting up host's sockets integration...	 [ OK ]
 Integrating host's themes, icons, fonts...	 [ OK ]
 Setting up package manager exceptions...	 [ OK ]
 Setting up sudo...                     	 [ OK ]
 Setting up groups...                   	 [ OK ]
 Setting up users...                    	 [ OK ]
 Executing init hooks...                	 [ OK ]

Container Setup Complete!
Welcome to fish, the friendly interactive shell
Type help for instructions on how to use fish

distrobox on  main [!⇡]
⬢ [fedora-toolbox:36] ❯
```

Enable PowerTools (recommended to use EPEL) and EPEL Next, so
`distrobox` can install the Fish shell.

```
distrobox on  main [!⇡]
✦ ❯ ./distrobox create -i quay.io/centos/centos:stream8 c8s --pre-init-hooks "dnf config-manager --enable powertools && dnf -y install epel-next-release"
9b17e8cfbf8e7a26abdc7a78b2325e1ee4a9577662b0fe94fbde4260269e1ce3
Distrobox 'c8s' successfully created.
To enter, run:

distrobox-enter c8s

distrobox on  main [!⇡]
✦ ❯ ./distrobox enter c8s
Container c8s is not runnung.
Starting container c8s
run this command to follow along:

 podman logs -f c8s

 Starting container...                  	 [ OK ]
 Executing pre-init hooks...            	 [ OK ]
 Installing basic packages...           	 [ OK ]
 Setting up read-only mounts...         	 [ OK ]
 Setting up read-write mounts...        	 [ OK ]
 Setting up host's sockets integration...	 [ OK ]
 Integrating host's themes, icons, fonts...	 [ OK ]
 Setting up package manager exceptions...	 [ OK ]
 Setting up sudo...                     	 [ OK ]
 Setting up groups...                   	 [ OK ]
 Setting up users...                    	 [ OK ]
 Executing init hooks...                	 [ OK ]

Container Setup Complete!
Welcome to fish, the friendly interactive shell
Type help for instructions on how to use fish

distrobox on  main
⬢ [centos:stream8] ❯
```

Signed-off-by: Michel Alexandre Salim <michel@michel-slm.name>

* Fix typo: s/runnung/running

Signed-off-by: Michel Alexandre Salim <michel@michel-slm.name>

* simplify pre-init-hooks detection, add useful tips

Signed-off-by: Michel Alexandre Salim <michel@michel-slm.name>

* More changes to address review feedback

- distrobox-init: indent new if block
- distrobox-create: restore quote around pre-init-hooks arguments
- docs/usage: document new create and init options
- docs/useful_tips: explain the rationale behind --pre-init-hooks

Signed-off-by: Michel Alexandre Salim <michel@michel-slm.name>
2022-05-15 20:14:24 +02:00
89luca89
2ace0e4e73 distrobox: add support for rootful containers
This commit will add the `--root/-r` flag to create,enter,list,rm,stop
commands. This will enable the use of podman/docker in root mode. This
is the preferred way over `sudo distrobox`.

Update man pages and docs accordingly.

Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2022-05-01 08:03:03 +02:00
89luca89
ac320cc40a docs: update and format docs 2022-04-05 17:12:42 +02:00
89luca89
8a8288b963 docs: update docs 2022-04-04 22:23:34 +02:00
89luca89
a1b3b9c800 docs: update overlayfs docs 2022-03-20 21:25:43 +00:00
89luca89
b38643c298 docs: add more usage examples and tips 2022-03-17 19:30:07 +00:00
89luca89
bf89f72708 export: support exporting of system flatpaks and document it, Fix #171 2022-03-17 19:14:31 +00:00
89luca89
8d8109913c docs: document ssh x forwarding, fix #172 2022-03-17 18:40:52 +00:00
89luca89
3c950a77b0 docs: update docs #173 2022-02-24 19:27:40 +01:00
89luca89
f39cba1e62 docs: update docs 2022-01-28 23:37:28 +01:00
89luca89
369b083840 docs: move gentoo docs, add image building instructions 2022-01-10 20:02:54 +01:00
89luca89
eb2e0afa6a docs: move gentoo docs, add image building instructions 2022-01-10 20:00:24 +01:00
89luca89
85aa591cc6 docs: update docs 2022-01-04 02:18:23 +01:00
89luca89
a8a1a83193 docs: update docs 2022-01-03 18:01:05 +01:00