Skip to content

Commit

Permalink
docs: Describe offline updates with static deltas
Browse files Browse the repository at this point in the history
This one isn't immediately obvious that it's possible.

Signed-off-by: Colin Walters <[email protected]>
  • Loading branch information
cgwalters committed May 16, 2024
1 parent 664116f commit 37b3c76
Showing 1 changed file with 32 additions and 0 deletions.
32 changes: 32 additions & 0 deletions docs/copying-deltas.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
nav_order: 101
---

# Static deltas for offline updates
{: .no_toc }

1. TOC
{:toc}

<!-- SPDX-License-Identifier: (CC-BY-SA-3.0 OR GFDL-1.3-or-later) -->

OSTree supports generating "self-contained" static delta files, via an
invocation similar to the following:

```
$ ostree --repo=/path/to/repo static-delta generate --min-fallback-size=0 --filename=delta-update-file --from=<from> <to>
```

Note the usage of `--min-fallback-size=0` to ensure that the delta is self-contained.

Then, you can copy `delta-update-file` to a USB key or similar, and a target system can apply it via e.g.:

```
$ ostree --repo=/ostree/repo static-delta apply-offline /path/to/delta-update-file
```

The above invocation will merely apply the content into the repository.
To make it bootable, this will then need to be further followed up by e.g. `ostree admin deploy <to>` or
with a higher level tool such as `rpm-ostree`, via `rpm-ostree deploy :<to>`.


0 comments on commit 37b3c76

Please sign in to comment.