summaryrefslogtreecommitdiff
path: root/README.md
blob: cba9db82f12b9709b94577abfb22209b40a22f91 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# Obnam – a backup system

Obnam2 is a project to develop a backup system.

You probably want to read the [obnam.md](obnam.md) subplot file.

## Client installation

See instructions at <https://obnam.org/download/> for installing the
client. It's not duplicated here to avoid having to keep the
information in sync in two places.

## Server installation

To install the Obnam server component, you need a Debian host with
sufficient disk space, and Ansible installed locally. Run the
following commands in the Obnam source tree, replacing
`obnam.example.com` with the domain name of your server:

```sh
$ cd ansible
$ printf '[server]\nobnam.example.com\n' > hosts
$ ansible-playbook -i hosts obnam-server.yml -e domain=obnam.example.com
```

The above gets a free TLS certificate from [Let's Encrypt][], but only
works if the server is accessible from the public Internet. For a
private host use the following instead:

```sh
$ cd ansible
$ printf '[server]\nprivate-vm\n' > hosts
$ ansible-playbook -i hosts obnam-server.yml
```

This uses a pre-created self-signed certificate from
`files/server.key` and `files/server.pem` and is probably only good
for trying out Obnam. You may want to generate your own certificates
instead.

To create a self-signed certificate, something like the following
command might work, using [OpenSSL]:

```sh
$ openssl req -x509 -newkey rsa:4096 -passout pass:hunter2 \
  -keyout key.pem -out cert.pem -days 365 -subj /CN=localhost
```


[Let's Encrypt]: https://letsencrypt.org/
[OpenSSL]: https://www.openssl.org/


## Legalese

Copyright 2020-2021  Lars Wirzenius

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.