distrobox/docs/usage/distrobox-rm.md

<!-- markdownlint-disable MD010 MD036 -->
# NAME

	distrobox rm

# DESCRIPTION

`distrobox rm` deletes one of the available distroboxes.

# SYNOPSIS

**distrobox rm**

	--all/-a:		delete all distroboxes
	--force/-f:		force deletion
	--yes/-Y:		non-interactive, skip the deletion confirmation prompt
	--rm-home:		remove the mounted home if it differs from the host user's one
	--root/-r:		launch podman/docker/lilipod with root privileges. Note that if you need root this is the preferred
				way over "sudo distrobox" (note: if using a program other than 'sudo' for root privileges is necessary,
				specify it through the DBX_SUDO_PROGRAM env variable, or 'distrobox_sudo_program' config variable)
	--help/-h:		show this message
	--verbose/-v:		show more verbosity
	--version/-V:		show version

# EXAMPLES

	distrobox rm container-name [--force] [--all]

You can also use environment variables to specify container manager and name:

	DBX_CONTAINER_MANAGER="docker" DBX_CONTAINER_NAME=test-alpine distrobox rm

# ENVIRONMENT VARIABLES

	DBX_CONTAINER_MANAGER
	DBX_CONTAINER_NAME
	DBX_NON_INTERACTIVE
	DBX_SUDO_PROGRAM