<commit_before>## buildah-rmi "1" "March 2017" "buildah"

## NAME
buildah rmi - Removes one or more images.

## SYNOPSIS
**buildah** **rmi** **imageID [...]**

## DESCRIPTION
Removes one or more locally stored images.

## OPTIONS

**--all, -a**

All local images will be removed from the system that do not have containers using the image as a reference image.

**--prune, -p**

All local images will be removed from the system that do not have a tag and do not have a child image pointing to them.

**--force, -f**

This option will cause Buildah to remove all containers that are using the image before removing the image from the system.

## EXAMPLE

buildah rmi imageID<commit_msg>Add limitation to buildah rmi man page<commit_after>## buildah-rmi "1" "March 2017" "buildah"

## NAME
buildah rmi - Removes one or more images.

## SYNOPSIS
**buildah** **rmi** **imageID [...]**

## DESCRIPTION
Removes one or more locally stored images.

## LIMITATIONS
If the image was pushed to a directory path using the 'dir:' transport
the rmi command can not remove the image.  Instead standard file system
commands should be used.

## OPTIONS

**--all, -a**

All local images will be removed from the system that do not have containers using the image as a reference image.

**--prune, -p**

All local images will be removed from the system that do not have a tag and do not have a child image pointing to them.

**--force, -f**

This option will cause Buildah to remove all containers that are using the image before removing the image from the system.

## EXAMPLE

buildah rmi imageID
{'fraction_non_alphanumeric': 0.09183027232425586, 'fraction_numerical': 0.006333122229259025, 'mean_word_length': 3.876543209876543, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7514915', 'n_tokens_mistral': 475, 'n_tokens_neox': 454, 'n_words': 243}