diff options
authorLars Wirzenius <>2021-03-14 09:18:38 +0000
committerLars Wirzenius <>2021-03-14 09:18:38 +0000
commitc228fe23bb4e4ae3c6a44f18a181d7079774e34a (patch)
parentaec405538602107e84e222c3aae0dd0e50b7cb45 (diff)
parentb62ce026392dd9b8bea06b04413931b0bbd75762 (diff)
Merge branch 'release' into 'main'v0.3.0
Prepare release 0.3.0 See merge request larswirzenius/obnam!117
3 files changed, 92 insertions, 2 deletions
diff --git a/Cargo.toml b/Cargo.toml
index fb0403f..dcaacde 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
name = "obnam"
-version = "0.2.2"
+version = "0.3.0"
authors = ["Lars Wirzenius <>"]
edition = "2018"
description = "a backup program"
diff --git a/NEWS b/NEWS
index cdd50df..6073b5c 100644
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-# NEWS for Obnam2, the backup software
+# Release notes for Obnam2, the backup software
This file summarizes changes between releases of the second generation
of Obnam, the backup software. The software is technically called
@@ -6,6 +6,90 @@ of Obnam, the backup software. The software is technically called
ended in 2017 with version number 1.22.
+## Obnam2 version 0.3.0, released 2021-03-14
+### Breaking changes
+* The format of the data stored on the backup repository has changed.
+ The new version can't restore old backups: old generations are now
+ useless. You'll have to start over. Sorry.
+### New or changed features
+* New `obnam config` sub-command writes out the actual configuration
+ that the program users, as read from the configuration file.
+* The client configuration now has default values for all
+ configuration fields that can reasonably have them. For example, it
+ is no longer necessary to explicitly set a chunk size.
+* Only known fields are now allowed in configuration files. Unknown
+ fields cause an error.
+* It is now possible to back up multiple, distinct directories with
+ one client configuration. The `root` configuration is now `roots`,
+ and is a list of directories.
+* Problems in backing up a file no longer terminate the backup run.
+ Instead, the problem is reported at the end of the backup run, as a
+ warning.
+* The client now requires an HTTPS URL for the server. Plain HTTP is
+ now rejected. The TLS certificate for the server is verified by
+ default, but that can be turned off.
+* The client progress reporting is now a little clearer.
+* Unix domain sockets and named pipes (FIFO files) are now backed up
+ and restored.
+* The names of the user and group owning a file are backed up, but not
+ restored.
+* On the Obnam server, the Ansible playbook now installs a cron job to
+ renew the Let's Encrypt TLS certificate.
+### Bugs fixed
+* Temporary files created during backup runs are now automatically
+ deleted, even if the Obnam client crashes.
+* Symbolic links are now backed up and restored correctly. Previously
+ Obnam followed the link when backing up and created the link
+ wrongly.
+* The Ansible playbook to provision an Obnam server now enables the
+ systemd unit so that the Obnam server process starts automatically
+ after a reboot.
+### Changes to documentation
+* A tutorial has been added.
+The Obnam subplot (``), which describes the requirements,
+acceptance criteria, and architecture of the software, has some
+* a discussion of why Obnam doesn't use content-addressable storage
+* a description of the logical structure of backups as stored on the
+ backup server
+* a rudimentary first sketch of a threat model: the operator of the
+ backup server reads the backed up data
+* an initial plan for adding support for encryption to backups; this
+ is known to be simplistic and inadequate, but the goal is to get
+ started, and then iterate to get something acceptable, even if that
+ takes months
+### Thank you
+Several people have helped with this release, with changes or
+feedback. I want to especially mention the following, with apologies
+to anyone I have inadvertently forgotten: Alexander Batischev, Ossi
+Herrala, Daniel Silverstone, Neal Walfield.
## Obnam2 version 0.2.2, released 2021-01-29
This is the first release of Obnam2. It can just barely make and
diff --git a/debian/changelog b/debian/changelog
index 136f47c..4433909 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+obnam (0.3.0-1) UNRELEASED; urgency=medium
+ * New release.
+ -- Lars Wirzenius <> Sun, 14 Mar 2021 11:15:25 +0200
obnam (0.2.2-1) unstable; urgency=low
* Initial packaging. This is not intended to be uploaded to Debian, so