diff --git a/pages/linux/distrobox-create.md b/pages/linux/distrobox-create.md index 6650aeecb2..8611c3bdb9 100644 --- a/pages/linux/distrobox-create.md +++ b/pages/linux/distrobox-create.md @@ -1,13 +1,13 @@ # distrobox-create -> Create Distrobox containers with an input name and image. +> Create a distrobox container. More about distrobox: `tldr distrobox`. > 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: . +> More information: . -- Create a distrobox using the Alpine image: +- Create a distrobox using the Ubuntu Linux image: -`distrobox-create {{container_name}} --image alpine` +`distrobox-create {{container_name}} --image {{ubuntu:latest}}` -- Clone a distrobox: +- Clone a distrobox container: `distrobox-create --clone {{container_name}} {{cloned_container_name}}` diff --git a/pages/linux/distrobox-enter.md b/pages/linux/distrobox-enter.md index 105f4e4df4..9cef44ac94 100644 --- a/pages/linux/distrobox-enter.md +++ b/pages/linux/distrobox-enter.md @@ -1,8 +1,12 @@ # distrobox-enter -> Run a command in a Distrobox container. +> Enter a distrobox container. More about distrobox: `tldr distrobox`. > 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: . +> More information: . + +- Enter a distrobox: + +`distrobox-enter {{container-name}}` - Enter a distrobox and run `sh -l`: diff --git a/pages/linux/distrobox-export.md b/pages/linux/distrobox-export.md new file mode 100644 index 0000000000..723d954180 --- /dev/null +++ b/pages/linux/distrobox-export.md @@ -0,0 +1,25 @@ +# distrobox-export + +> Export app/service/binary from container to host OS. +> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. +> More information: . + +- Export an app (eg: gedit) from the container to the host (will show up in your host system's application list): + +`distrobox-export --app {{gedit}} --extra-flags "--foreground"` + +- Export a binary from the container to the host: + +`distrobox-export --bin {{path/to/binary}} --export-path {{path/to/binary_on_host}}` + +- Export a binary (eg: ranger) from the container to the host: + +`distrobox-export --bin {{/usr/bin/ranger}} --export-path {{$HOME/.local/bin}}` + +- Export a service (eg: syncthing) from container to the host (`--sudo` will run the service as root inside the container): + +`distrobox-export --service {{syncthing}} --extra-flags "--allow-newer-config" --sudo` + +- Unexport/delete an exported app (eg: gedit): + +`distrobox-export --app {{gedit}} --delete` diff --git a/pages/linux/distrobox-host-exec.md b/pages/linux/distrobox-host-exec.md new file mode 100644 index 0000000000..f4f858a440 --- /dev/null +++ b/pages/linux/distrobox-host-exec.md @@ -0,0 +1,13 @@ +# distrobox-host-exec + +> Execute a command on host while inside a distrobox container. +> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. +> More information: . + +- Execute command on the host system, while inside of a container: + +`distrobox-host-exec "{{command}}"` + +- Execute `ls` command on the host system, while inside of a container: + +`distrobox-host-exec ls` diff --git a/pages/linux/distrobox-list.md b/pages/linux/distrobox-list.md index f353bba419..148e1f220b 100644 --- a/pages/linux/distrobox-list.md +++ b/pages/linux/distrobox-list.md @@ -1,7 +1,8 @@ # distrobox-list -> List available Distrobox containers. It detects them and lists them separately from the rest of normal podman or Docker containers. -> More information: . +> List all distrobox containers. More about distrobox: `tldr distrobox`. +> It detects them and lists them separately from the rest of normal podman or Docker containers. +> More information: . - List all distrobox containers: @@ -9,4 +10,4 @@ - List all distrobox containers with verbose information: -`distrobox-list -v` +`distrobox-list --verbose` diff --git a/pages/linux/distrobox-rm.md b/pages/linux/distrobox-rm.md index 6183c08896..e847acf8e8 100644 --- a/pages/linux/distrobox-rm.md +++ b/pages/linux/distrobox-rm.md @@ -1,9 +1,10 @@ # distrobox-rm -> Delete Distrobox containers. -> More information: . +> Remove a distrobox container. +> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. +> More information: . -- Remove a distrobox: +- Remove a distrobox (remember to stop container before removing it): `distrobox-rm {{container_name}}` diff --git a/pages/linux/distrobox-stop.md b/pages/linux/distrobox-stop.md new file mode 100644 index 0000000000..e578c51f65 --- /dev/null +++ b/pages/linux/distrobox-stop.md @@ -0,0 +1,9 @@ +# distrobox-stop + +> Stop a distrobox container. +> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. +> More information: . + +- Stop a distrobox container: + +`distrobox-stop {{container-name}}` diff --git a/pages/linux/distrobox-upgrade.md b/pages/linux/distrobox-upgrade.md new file mode 100644 index 0000000000..b09f065c3e --- /dev/null +++ b/pages/linux/distrobox-upgrade.md @@ -0,0 +1,17 @@ +# distrobox-upgrade + +> Upgrade a distrobox container. +> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. +> More information: . + +- Upgrade a container using the container's package manager: + +`distrobox-upgrade {{container_name}}` + +- Upgrade all containers using the containers' package managers: + +`distrobox-upgrade --all` + +- Upgrade specific containers via containers' package managers: + +`distrobox-upgrade {{container1 container2 ...}}` diff --git a/pages/linux/distrobox.md b/pages/linux/distrobox.md new file mode 100644 index 0000000000..5dcce1f75c --- /dev/null +++ b/pages/linux/distrobox.md @@ -0,0 +1,37 @@ +# distrobox + +> Use any Linux distribution inside your terminal by running it as a container. Install & use packages inside it while tightly integrating with host OS, sharing storage, HOME directory with GUI & audio capabilities. +> You can install any software inside it. Eg: installing a `.deb` package inside an ubuntu container running on an Arch Linux host system. Packages inside container can access host's files. +> More information: . + +- Show tldr page for distrobox-create (creating containers): + +`tldr distrobox-create` + +- Show tldr page for distrobox-list (list container info): + +`tldr distrobox-list` + +- Show tldr page for distrobox-enter (enter inside containers): + +`tldr distrobox-enter` + +- Show tldr page for distrobox-host-exec (Execute command on host while inside a container): + +`tldr distrobox-host-exec` + +- Show tldr page for distrobox-export (Export app/service/binary from container to host): + +`tldr distrobox-export` + +- Show tldr page for distrobox-upgrade (upgrade containers): + +`tldr distrobox-upgrade` + +- Show tldr page for distrobox-stop (stop containers): + +`tldr distrobox-stop` + +- Show tldr page for distrobox-rm (remove containers): + +`tldr distrobox-rm`