---
name: "mkapfs"
section: "8"
platform: "linux"
package: "apfsprogs"
version: "0.2.1-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mkapfs"
---

# mkapfs(8)

create an APFS filesystem

## NAME

mkapfs - create an APFS filesystem

## SYNOPSIS

**mkapfs** \[-sv\] \[-L *label*\] \[-U *UUID*\] \[-u *UUID*\] \[-F *tier2*\] \[-B *tier2-blocks*\] *device* \[*blocks*\]

## DESCRIPTION

**mkapfs** is an experimental tool to create an APFS filesystem with a single volume on the given *device*. The number of blocks for the device can be specified in *blocks*, otherwise the whole disk is used.

## OPTIONS

- **-s**

  Enable case sensitivity for the volume.

- **-z**

  Enable normalization sensitivity for the volume.

- **-L** *label*

  Set a label for the volume, with a maximum length of 255 bytes.

- **-U** *UUID*

  Specify a UUID for the container, in the standard format. By default the value is chosen by /proc/sys/kernel/random/uuid.

- **-u** *UUID*

  Specify a UUID for the volume, in the standard format. By default the value is chosen by /proc/sys/kernel/random/uuid.

- **-v**

  Print the version number of **mkapfs** and exit.

- **-F** *tier2*

  Specify the tier 2 device for a fusion drive.

- **-B** *tier2-blocks*

  Specify the size (in blocks) for the tier 2 device given by the **-F** option. By default the whole disk is used.

## REPORTING BUGS

Please report bugs via email or, if preferred, file a github issue at https://github.com/eafer/apfsprogs/issues.

## AUTHOR

Written by Ernesto A. Fernández \<ernesto.mnd.fernandez@gmail.com\>.

## SEE ALSO

[**apfsck**(8)](/apfsck/8.md)