BUPSTASH-RESTORE(1)              User Commands             BUPSTASH-RESTORE(1)

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

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

       bupstash restore [<?><?><?><?><?><?><?><?>] --into $PATH QUERY...

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

       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       (<?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>)<?> bupstash restore
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       xattrs <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> --ownership <?> --xattrs
       <?><?> <?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> bupstash put
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

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

<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (QUERY CACHING)
       <?><?><?><?><?> restore <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> bupstash-list(1)
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (SPARSE FILES)
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> 'put'
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> (sparse)
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> restore
       <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       --into PATH
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> BUPSTASH_RESTORE_DIR <?><?><?>.

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

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

       --pick PATH
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?>.

       --ownership
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (uid) <?> <?><?><?><?><?> (gid).

       --xattrs
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (xattrs).

       --indexer-threads N
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.

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

       --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
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>.

       BUPSTASH_RESTORE_DIR
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              --into <?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       $ bupstash restore --into ./dir id=ad8*

   <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?>
       $ bupstash restore --ownership --into ./dir id=ad8*

   <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?>
       $ bupstash restore --into ./dir --pick sub/dir id=ad8*

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

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