---
name: "distrobox-init"
section: "1"
platform: "linux"
package: "distrobox"
version: "1.8.2.5-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/distrobox-init"
---

# distrobox-init(1)

## NAME

-

  ```
  distrobox-init
  ```

## DESCRIPTION

**Init the distrobox (not to be launched manually)**

distrobox-init is the entrypoint of a created distrobox. Note that this HAS to run from inside a distrobox, will not work if you run it from your host.

**This is not intended to be used manually, but instead used by** **distrobox-create to set up the container’s entrypoint.**

distrobox-init will take care of installing missing dependencies (eg. sudo), set up the user and groups, mount directories from the host to ensure the tight integration.

## SYNOPSIS

**distrobox-init**

-

  ```
  --name/-n:      user name
  --user/-u:      uid of the user
  --group/-g:     gid of the user
  --home/-d:      path/to/home of the user
  --help/-h:      show this message
  --additional-packages:  packages to install in addition
  --init/-I:      whether to use or not init
  --pre-init-hooks:   commands to execute prior to init
  --nvidia:       try to integrate host's nVidia drivers in the guest
  --upgrade/-U:       run init in upgrade mode
  --verbose/-v:       show more verbosity
  --version/-V:       show version
  --:         end arguments execute the rest as command to execute during init
  ```

## EXAMPLES

-

  ```
  distrobox-init --name test-user --user 1000 --group 1000 --home /home/test-user
  distrobox-init --upgrade
  ```