Distrobox - Revision history

John3-16: 1. Reworded introduction to complement the link's description further; 2. Updated electron package names; 3. Added --enable-features=UseOzonePlatform,WaylandWindowDecorations flag to run electron v.38 packages; 4. Style and grammar amendments.

2025-10-28T14:03:16Z

1. Reworded introduction to complement the link's description further; 2. Updated electron package names; 3. Added --enable-features=UseOzonePlatform,WaylandWindowDecorations flag to run electron v.38 packages; 4. Style and grammar amendments.

← Older revision		Revision as of 14:03, 28 October 2025
Line 1:		Line 1:
	[https://distrobox.it/ Distrobox] ~~allows running any Linux distribution inside your terminal. Distrobox~~ uses [[Podman]], [[Docker]] etc.. to ~~create containers using the~~ Linux distribution of ~~your choice. This enables both backward~~ and ~~forward compatibility with software~~ and ~~freedom to use whatever distribution you’re more comfortable with~~.		[https://distrobox.it/ Distrobox] is a container wrapping layer that uses a container such as [[Podman]], [[Docker]], etc., to run your choice of Linux distribution or GUI apps (both '''Wayland''' and '''X11''') from a terminal while enabling the use of the user's {{Path\|$HOME}} directory and external USB devices and storage. It runs on the Linux kernel natively. As a launcher of containers, it is distinct from [https://webassembly.org/ WebAssembly (Wasm)].

	== Installation ==		== Installation ==

	Installing {{pkg\|distrobox}} package automatically installs [[Podman]] as a dependency~~, on~~ issuing the command:{{cmd\|# apk add {{pkg\|distrobox}}}}		Installing the {{pkg\|distrobox}} package automatically installs [[Podman]] as a dependency upon issuing the command:
			{{cmd\|# apk add {{pkg\|distrobox}}}}

	== Running graphical programs ==		== Running graphical programs ==
Line 9:		Line 10:
	Configure Podman to run in [[Podman#Running in rootless mode\|rootless mode]].		Configure Podman to run in [[Podman#Running in rootless mode\|rootless mode]].

	Create a container using an image of your choice. Here Debian is installed using the command:{{cmd\|$ distrobox create --name my-debian --image debian		Create a container using an image of your choice. Here, Debian is installed using the command:
			{{cmd\|$ distrobox create --name my-debian --image debian
	$ distrobox enter my-debian}}		$ distrobox enter my-debian}}

	When [[Wayland]] desktop like [[Sway]] ~~runs~~ without {{pkg\|xwayland}} on the Alpine Linux host, electron apps ~~like~~ {{ic\|~~vscode~~}}, {{ic\|~~google-chrome~~}} etc ~~needs~~ to be started as follows:{{ic\|<nowiki>$ distrobox enter my-debian -- code --ozone-platform=wayland</nowiki>}}.		When [[Wayland]] desktop environments like [[Sway]] run without {{pkg\|xwayland}} on the Alpine Linux host, electron apps such as {{pkg\|code-oss}}, {{pkg\|vscodium}}, or {{pkg\|chromium}}, etc., need to be started as follows:
			{{cmd\|<nowiki>$ distrobox enter my-debian -- code --enable-features=UseOzonePlatform,WaylandWindowDecorations --ozone-platform=wayland</nowiki>}}

	If you are running X11 desktop, it may also be necessary to allow X authorization for GUI programs to work: {{ic\|$ xhost +si:localuser:$USER}}		If you are running an '''X11''' desktop, it may also be necessary to allow '''X''' authorization in order for GUI programs to work:
			{{cmd\|$ xhost +si:localuser:$USER}}

	== Troubleshooting ==		== Troubleshooting ==

Prabuanand: moved troubleshooting content by user Lilith to Podman page

2025-09-23T03:48:00Z

moved troubleshooting content by user Lilith to Podman page

← Older revision		Revision as of 03:48, 23 September 2025
Line 18:		Line 18:
	== Troubleshooting ==		== Troubleshooting ==

	~~=== Permission problems with rootless Podman ===~~

	~~You may encounter an error when entering your rootless container:~~

	<code>Error: unable to start container "XYZ": runc: runc create failed: unable to start container process: unable to apply cgroup configuration: rootless needs no limits + no cgrouppath when no permission is granted for cgroups: mkdir /sys/fs/cgroup/XYZ: permission denied: OCI permission denied</code>

	~~This problem may be solved by installing {{Pkg\|crun}}: {{Cmd\|# apk add crun}}~~

	~~and recreating your container. Keep in mind that {{Pkg\|crun}} replaces {{Pkg\|runc}}, which will render containers made with the latter unusable until recreated.~~

	== See also ==		== See also ==

Lilith: add important remark to my earlier troubleshooting contribution

2025-09-22T20:19:09Z

add important remark to my earlier troubleshooting contribution

← Older revision		Revision as of 20:19, 22 September 2025
Line 26:		Line 26:
	This problem may be solved by installing {{Pkg\|crun}}: {{Cmd\|# apk add crun}}		This problem may be solved by installing {{Pkg\|crun}}: {{Cmd\|# apk add crun}}

	and recreating your container.		and recreating your container. Keep in mind that {{Pkg\|crun}} replaces {{Pkg\|runc}}, which will render containers made with the latter unusable until recreated.

	== See also ==		== See also ==

Lilith at 19:39, 22 September 2025

2025-09-22T19:39:46Z

← Older revision		Revision as of 19:39, 22 September 2025
Line 15:		Line 15:

	If you are running X11 desktop, it may also be necessary to allow X authorization for GUI programs to work: {{ic\|$ xhost +si:localuser:$USER}}		If you are running X11 desktop, it may also be necessary to allow X authorization for GUI programs to work: {{ic\|$ xhost +si:localuser:$USER}}

			== Troubleshooting ==

			=== Permission problems with rootless Podman ===

			You may encounter an error when entering your rootless container:

			<code>Error: unable to start container "XYZ": runc: runc create failed: unable to start container process: unable to apply cgroup configuration: rootless needs no limits + no cgrouppath when no permission is granted for cgroups: mkdir /sys/fs/cgroup/XYZ: permission denied: OCI permission denied</code>

			This problem may be solved by installing {{Pkg\|crun}}: {{Cmd\|# apk add crun}}

			and recreating your container.

	== See also ==		== See also ==
Line 21:		Line 33:
	* [[Podman]]		* [[Podman]]
	* [[Docker]]		* [[Docker]]


	[[Category:Virtualization]]		[[Category:Virtualization]]

Prabuanand: created headings

2025-07-05T07:37:19Z

created headings

← Older revision		Revision as of 07:37, 5 July 2025
Line 1:		Line 1:
	[https://distrobox.it/ Distrobox] allows running any Linux distribution inside your terminal. Distrobox uses [[Podman]], [[Docker]] etc.. to create containers using the Linux distribution of your choice. This enables both backward and forward compatibility with software and freedom to use whatever distribution you’re more comfortable with.		[https://distrobox.it/ Distrobox] allows running any Linux distribution inside your terminal. Distrobox uses [[Podman]], [[Docker]] etc.. to create containers using the Linux distribution of your choice. This enables both backward and forward compatibility with software and freedom to use whatever distribution you’re more comfortable with.

			== Installation ==

	Installing {{pkg\|distrobox}} package automatically installs [[Podman]] as a dependency, on issuing the command:{{cmd\|# apk add {{pkg\|distrobox}}}}		Installing {{pkg\|distrobox}} package automatically installs [[Podman]] as a dependency, on issuing the command:{{cmd\|# apk add {{pkg\|distrobox}}}}

			== Running graphical programs ==

	Configure Podman to run in [[Podman#Running in rootless mode\|rootless mode]].		Configure Podman to run in [[Podman#Running in rootless mode\|rootless mode]].

Prabuanand: moved content from Software management page to seperate page

2025-07-05T07:32:31Z

moved content from Software management page to seperate page

New page

[https://distrobox.it/ Distrobox] allows running any Linux distribution inside your terminal. Distrobox uses [[Podman]], [[Docker]] etc.. to create containers using the Linux distribution of your choice. This enables both backward and forward compatibility with software and freedom to use whatever distribution you’re more comfortable with.

Installing {{pkg|distrobox}} package automatically installs [[Podman]] as a dependency, on issuing the command:{{cmd|# apk add {{pkg|distrobox}}}}

Configure Podman to run in [[Podman#Running in rootless mode|rootless mode]].

Create a container using an image of your choice. Here Debian is installed using the command:{{cmd|$ distrobox create --name my-debian --image debian
$ distrobox enter my-debian}}

When [[Wayland]] desktop like [[Sway]] runs without {{pkg|xwayland}} on the Alpine Linux host, electron apps like {{ic|vscode}}, {{ic|google-chrome}} etc needs to be started as follows:{{ic|<nowiki>$ distrobox enter my-debian -- code --ozone-platform=wayland</nowiki>}}.

If you are running X11 desktop, it may also be necessary to allow X authorization for GUI programs to work: {{ic|$ xhost +si:localuser:$USER}}

== See also ==

* [https://distrobox.it/ Official website]
* [[Podman]]
* [[Docker]]

[[Category:Virtualization]]