BUPSTASH-RM(1)                   User Commands                  BUPSTASH-RM(1)

<?><?><?> (NAME)
       bupstash-rm - <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       bupstash

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> bupstash.

       bupstash rm [<?><?><?><?><?><?><?><?>] <?><?><?><?><?><?><?>...

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bupstash rm <?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?> bupstash <?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> bupstash-gc(1)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?>.

<?><?><?><?> <?><?><?><?><?><?><?> (QUERY LANGUAGE)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> bupstash-query-language(7)
       <?><?><?><?><?><?> <?><?><?><?>.

   <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       $ id=$(bupstash put ./some-data)

       $ bupstash rm id=$id

       $ bupstash rm name=backups.tar

       $ bupstash rm --allow-many name='*.tar' and older-than 30d

       $ bupstash rm --allow-many id="*"

<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (QUERY CACHING)
       <?><?><?><?><?> rm <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> bupstash-list(1)
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (query cache) <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -r, --repository REPO
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?>. <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> ssh <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              ssh://$SERVER/$PATH <?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?> BUPSTASH_REPOSITORY <?><?><?><?><?>
              <?><?><?><?><?><?>.

       -k, --key KEY
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> BUPSTASH_KEY <?><?><?><?><?> <?><?><?>.

       --query-cache PATH
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> (query-cache)<?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?>: $BUPSTASH_QUERY_CACHE
              <?><?> $XDG_CACHE_HOME/.cache/bupstash/bupstash.qcache <?><?>
              $HOME/.cache/bupstash/bupstash.qcache.

       --query-encrypted
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> 'decryption-key-id' <?><?> <?><?><?>
              <?><?><?><?><?><?>.

       --ids-from-stdin
              <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdin)<?>
              <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       --allow-many
              <?><?> <?><?><?> <?><?><?><?><?><?><?> bupstash <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       --utc-timestamps
              <?><?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> (UTC) <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?>.

       --no-progress
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> (<?><?><?> stderr <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>).

       -q, --quiet
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              --no-progress <?><?><?>.

<?><?><?><?> (ENVIRONMENT)
       BUPSTASH_REPOSITORY
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?>. <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> ssh <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              ssh://$SERVER/$PATH <?><?><?><?>.

       BUPSTASH_REPOSITORY_COMMAND
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
              bupstash-serve(1).  <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       BUPSTASH_KEY
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?>.

       BUPSTASH_KEY_COMMAND
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              BUPSTASH_KEY <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?>.

       BUPSTASH_QUERY_CACHE
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> (query cache) <?><?><?>
              <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?>
       $ bupstash rm id=14ebd2073b258b1f55c5bbc889c49db4

   <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       $ bupstash rm id="*"

   <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?> backup.tar <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       $ bupstash rm name=backup.tar and older-than 30d

   <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>
        $ bupstash list --format=jsonl1 \
           | custom-json-filter \
           | bupstash rm --ids-from-stdin

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       bupstash(1), bupstash-list(1), bupstash-gc(1),
       bupstash-query-language(7)

bupstash                          2026-09-01                    BUPSTASH-RM(1)