(cut_command_reference)=
# cut command

The **cut** command uses the provided selection of package slices to create a
new file system tree in the root location.

By default it fetches the slices for the same Ubuntu version as the
current host, unless the `--release` option is used.

## Options

<!-- Start: cut command options -->

- `--release` is a {{chisel_releases_repo}} branch or local directory (e.g. ubuntu-22.04).
- `--root` is the path for the resulting root file system.
- `--arch` is used to specify the desired package architecture.

<!-- End: cut command options -->

## Example

To install the `hello_bins` slice from Ubuntu 24.04 for `amd64` architecture,
we can run the following:

<!-- Start: hello_bins installation -->

```{terminal}
:input: chisel cut --release ubuntu-24.04 --root rootfs/ hello_bins

2024/11/26 12:21:35 Consulting release repository...
2024/11/26 12:21:37 Cached ubuntu-24.04 release is still up-to-date.
2024/11/26 12:21:37 Processing ubuntu-24.04 release...
2024/11/26 12:22:12 Selecting slices...
2024/11/26 12:22:12 Fetching ubuntu 24.04 noble suite details...
2024/11/26 12:22:15 Release date: Thu, 25 Apr 2024 15:10:33 UTC
2024/11/26 12:22:15 Fetching index for ubuntu 24.04 noble main component...
2024/11/26 12:22:15 Fetching index for ubuntu 24.04 noble universe component...
2024/11/26 12:22:16 Fetching ubuntu 24.04 noble-security suite details...
2024/11/26 12:22:16 Release date: Tue, 26 Nov 2024  3:33:31 UTC
2024/11/26 12:22:16 Fetching index for ubuntu 24.04 noble-security main component...
2024/11/26 12:22:16 Fetching index for ubuntu 24.04 noble-security universe component...
2024/11/26 12:22:16 Fetching ubuntu 24.04 noble-updates suite details...
2024/11/26 12:22:17 Release date: Tue, 26 Nov 2024  5:53:50 UTC
2024/11/26 12:22:17 Fetching index for ubuntu 24.04 noble-updates main component...
2024/11/26 12:22:18 Fetching index for ubuntu 24.04 noble-updates universe component...
2024/11/26 12:22:19 Fetching pool/main/b/base-files/base-files_13ubuntu10.1_amd64.deb...
2024/11/26 12:22:19 Fetching pool/main/h/hello/hello_2.10-3build1_amd64.deb...
2024/11/26 12:22:19 Fetching pool/main/g/glibc/libc6_2.39-0ubuntu8.3_amd64.deb...
2024/11/26 12:22:19 Extracting files from package "base-files"...
2024/11/26 12:22:19 Extracting files from package "hello"...
2024/11/26 12:22:19 Extracting files from package "libc6"...
```

<!-- End: hello_bins installation -->