From 26adab31c66345a0ae5fc2deaf410167cbda10ef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mi=C5=A1o=20Bari=C5=A1i=C4=87?=
 <50531162+misobarisic@users.noreply.github.com>
Date: Sat, 22 Jan 2022 20:28:05 +0100
Subject: [PATCH] distrobox: add page (#7638)

---
 pages/linux/distrobox-create.md | 13 +++++++++++++
 pages/linux/distrobox-enter.md  | 13 +++++++++++++
 pages/linux/distrobox-list.md   | 12 ++++++++++++
 pages/linux/distrobox-rm.md     | 12 ++++++++++++
 4 files changed, 50 insertions(+)
 create mode 100644 pages/linux/distrobox-create.md
 create mode 100644 pages/linux/distrobox-enter.md
 create mode 100644 pages/linux/distrobox-list.md
 create mode 100644 pages/linux/distrobox-rm.md

diff --git a/pages/linux/distrobox-create.md b/pages/linux/distrobox-create.md
new file mode 100644
index 000000000..6650aeecb
--- /dev/null
+++ b/pages/linux/distrobox-create.md
@@ -0,0 +1,13 @@
+# distrobox-create
+
+> Create Distrobox containers with an input name and image.
+> The created container will be tightly integrated with the host, allowing sharing of the HOME directory of the user, external storage, external usb devices and graphical apps (X11/Wayland), and audio.
+> More information: <https://distrobox.privatedns.org>.
+
+- Create a distrobox using the Alpine image:
+
+`distrobox-create {{container_name}} --image alpine`
+
+- Clone a distrobox:
+
+`distrobox-create --clone {{container_name}} {{cloned_container_name}}`
diff --git a/pages/linux/distrobox-enter.md b/pages/linux/distrobox-enter.md
new file mode 100644
index 000000000..105f4e4df
--- /dev/null
+++ b/pages/linux/distrobox-enter.md
@@ -0,0 +1,13 @@
+# distrobox-enter
+
+> Run a command in a Distrobox container.
+> Default command executed is your SHELL, but you can specify different shells or entire commands to execute. If used inside a script, an application, or a service, you can specify the --headless mode to disable tty and interactivity.
+> More information: <https://distrobox.privatedns.org>.
+
+- Enter a distrobox and run `sh -l`:
+
+`distrobox-enter container-name -- sh -l`
+
+- Enter a distrobox without instantiating a tty:
+
+`distrobox-enter -H container-name -- uptime -p`
diff --git a/pages/linux/distrobox-list.md b/pages/linux/distrobox-list.md
new file mode 100644
index 000000000..f353bba41
--- /dev/null
+++ b/pages/linux/distrobox-list.md
@@ -0,0 +1,12 @@
+# distrobox-list
+
+> List available Distrobox containers. It detects them and lists them separately from the rest of normal podman or Docker containers.
+> More information: <https://distrobox.privatedns.org>.
+
+- List all distrobox containers:
+
+`distrobox-list`
+
+- List all distrobox containers with verbose information:
+
+`distrobox-list -v`
diff --git a/pages/linux/distrobox-rm.md b/pages/linux/distrobox-rm.md
new file mode 100644
index 000000000..6183c0889
--- /dev/null
+++ b/pages/linux/distrobox-rm.md
@@ -0,0 +1,12 @@
+# distrobox-rm
+
+> Delete Distrobox containers.
+> More information: <https://distrobox.privatedns.org>.
+
+- Remove a distrobox:
+
+`distrobox-rm {{container_name}}`
+
+- Remove a distrobox forcefully:
+
+`distrobox-rm {{container_name}} --force`