'\" t
.\"     Title: ostree prune
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 04/13/2026
.\"    Manual: ostree prune
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE PRUNE" "1" "" "OSTree" "ostree prune"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ostree-prune \- Search for unreachable objects
.SH "SYNOPSIS"
.HP \w'\fBostree\ prune\fR\ 'u
\fBostree prune\fR [OPTIONS...]
.SH "DESCRIPTION"
.PP
This searches for unreachable objects in the current repository\&. If unreachable objects are found, the command delete them to free space\&. If the
\fB\-\-no\-prune\fR
option is invoked, the command will just print unreachable objects and recommend deleting them\&.
.SH "OPTIONS"
.PP
\fB\-\-no\-prune\fR
.RS 4
Only display unreachable objects; don\*(Aqt delete\&.
.RE
.PP
\fB\-\-refs\-only\fR
.RS 4
Only compute reachability via refs\&.
.RE
.PP
\fB\-\-delete\-commit\fR=COMMIT
.RS 4
Specify a COMMIT to delete\&.
.RE
.PP
\fB\-\-keep\-younger\-than\fR=DATE
.RS 4
All commits older than DATE will be pruned\&. The format of DATE is the same as that accepted by GNU
date
utility \- for more information see
info date\&.
.RE
.PP
\fB\-\-depth\fR=DEPTH
.RS 4
Only traverse DEPTH (integer) parents for each commit (default: \-1=infinite)\&.
.RE
.PP
\fB\-\-static\-deltas\-only\fR=DEPTH
.RS 4
This option may currently
\fIonly\fR
be used in combination with
\fB\-\-delete\-commit\fR\&. Previous versions of ostree silently accepted the option without that, and ignored it\&. However, there are desired use cases for pruning just static deltas (while retaining the commits), and it\*(Aqs likely at some point this option will be supported for use cases outside of just
\fB\-\-delete\-commit\fR\&.
.RE
.PP
\fB\-\-commit\-only\fR
.RS 4
Only traverse and delete commit objects\&. This leaves orphaned meta and content objects, which can be cleaned up with another prune invocation\&. One may want to use this option to cheaply delete multiple commits, and then clean up with a more expensive prune at the end\&.
.RE
.SH "EXAMPLE"
.PP
\fB$ ostree prune\fR
.sp
.if n \{\
.RS 4
.\}
.nf
        Total objects: 25627
        No unreachable objects
.fi
.if n \{\
.RE
.\}
