Commit Graph

1301 Commits

Author SHA1 Message Date
Ori Livneh 92049f5405 Fix reference in FAQ 2019-05-12 13:35:31 -04:00
Thomas Waldmann 3082b1f1eb compact: move --cleanup-commits description from examples to docs 2019-05-06 23:10:07 +02:00
Thomas Waldmann 78cb2b1de5 build_man 2019-04-22 18:00:56 +02:00
Thomas Waldmann 1f527464ab build_usage 2019-04-22 18:00:28 +02:00
Thomas Waldmann 0b65a79a79 update CHANGES (master) 2019-04-22 17:54:43 +02:00
Thomas Waldmann e74f4adea1 update CHANGES (master) 2019-04-20 18:33:42 +02:00
Mike ef90cda43a Add "SSH Configuration" section (#4493)
Add "SSH Configuration" section

Add "SSH Configuration" section to "borg serve" documentation, to outline ssh/sshd configuration to prevent borg serve keeping a lock on a repo in the event the ssh connection is abnormally disconnected.

In response to issues #3988, #636 and #4485 (and probably others).
2019-04-08 21:10:26 +02:00
Thomas Waldmann 572a778554 build_man 2019-03-21 21:11:46 +01:00
Thomas Waldmann 9c380405a2 build_usage 2019-03-21 21:11:18 +01:00
Thomas Waldmann f1d23e0963 add release date 2019-03-21 21:08:08 +01:00
Thomas Waldmann 3157809719 update CHANGES (master) 2019-03-21 20:35:13 +01:00
Thomas Waldmann 060fb02112 docs: update requirements, fixes #4374
also some other minor install docs updates, to be continued...
2019-03-20 00:01:30 +01:00
Thomas Waldmann f922cdd803 docs: remove libzmq3* for debian/ubuntu 2019-03-19 23:19:38 +01:00
Thomas Waldmann f8371898ae docs: mention pkg-config / pkgconfig requirement, fixes #4452
both are required before invoking setup.py.

also mention libb2 requirement for pkgconfig being able to discover it.
2019-03-19 23:17:15 +01:00
Thomas Waldmann e69b8996cc docs: remove zeromq requirement
borg currently does not use zeromq.
2019-03-19 23:06:24 +01:00
Thomas Waldmann 22e021a5ce docs: install libcrypt-devel on cygwin
this is included into Python.h, thus needed when compiling stuff.
2019-03-19 22:38:09 +01:00
Thomas Waldmann ad5fbd9485 update CHANGES (master)
also: markup fixes
2019-03-17 21:49:30 +01:00
Sitaram Chamarty 884798c3cb add a sample logging.conf in docs/misc (#4380)
add a sample logging.conf in docs/misc

(and point to it in the man page)
2019-03-17 15:05:04 +01:00
Alexandr Kozlinskiy b780c36811 docs: fix spelling errors 2019-03-11 22:40:03 +01:00
Thomas Waldmann 39300d1fd0 docs: fix markup 2019-03-11 00:16:12 +01:00
Thomas Waldmann 1386c67513 build_man 2019-03-11 00:11:50 +01:00
Thomas Waldmann 9507856049 build_usage 2019-03-11 00:11:16 +01:00
Thomas Waldmann 621476b027 release date 2019-03-11 00:08:25 +01:00
TW 65bc71a192
update CHANGES (master) (#4429) 2019-03-11 00:06:43 +01:00
TW d7c6399396
Merge pull request #4384 from milkey-mouse/append-only-docs-3504
Elaborate on append-only mode docs
2019-03-10 15:04:23 +01:00
Thomas Waldmann 7ad5290501 redo stale lock handling, fixes #3986
drop BORG_HOSTNAME_IS_UNIQUE (please use BORG_HOST_ID if needed)

borg now always assumes it has a unique hostid - either automatically
from fqdn plus uuid.getnode() or overridden via BORG_HOST_ID.
2019-03-04 21:07:05 +01:00
Thomas Waldmann abdf5d0706 update CHANGES (master) 2019-03-03 14:16:52 +01:00
jminer74 a2c84215af docs/installation: added Alpine Linux to distribution list (#4414)
docs/installation: added Alpine Linux to distribution list
2019-03-01 22:11:48 +01:00
Thomas Waldmann 8b55bb1096 update CHANGES 2019-02-26 22:50:40 +01:00
Thomas Waldmann 032a4effd3 build_man 2019-02-24 20:40:07 +01:00
Thomas Waldmann bece7e8090 build_usage 2019-02-24 20:39:42 +01:00
Thomas Waldmann 34fa89b26c add release date 2019-02-24 20:34:44 +01:00
Thomas Waldmann 2e5e3a87e1 update CHANGES (master) 2019-02-24 19:23:47 +01:00
Thomas Waldmann 9637c3fbb3 update 1.1.6..1.1.9 sections of CHANGES (from 1.1-maint) 2019-02-24 15:53:02 +01:00
Thomas Waldmann 1344779113 update severe issues section of CHANGES (from 1.1-maint) 2019-02-24 15:50:37 +01:00
Milkey Mouse cb2b86274e
Elaborate on append-only mode docs 2019-02-22 19:05:29 -08:00
Thomas Waldmann 2713500983 remove -*- coding: ... lines, utf-8 is default for py3 2019-02-22 17:12:05 +01:00
Milkey Mouse 7ea2bd1389
Only modify window.location when redirecting (fixes #4133)
window.location.pathname = window.location.pathname can trigger a redirect,
which created a refresh loop in usage.html.
2019-02-20 11:12:45 -08:00
Milkey Mouse 453e4a4b92
Update copyright year 2019-02-19 20:20:13 -08:00
Thomas Waldmann 7f46eb99aa update docs about fixed chunker and chunker algo spec needed 2019-02-13 06:30:13 +01:00
Thomas Waldmann 305efb5b01 signing binaries with Qubes OS support, docs 2019-02-11 02:44:44 +01:00
anarcat 10a4e011c0 add warnings on repository copies to avoid future problem like #4272 (#4285)
docs: add warnings about repo copies to avoid problems like #4272
2019-02-10 20:23:59 +01:00
Thomas Waldmann f7525156c1 update release workflow using twine (docs, scripts), see #4213 2019-02-01 22:07:49 +01:00
Manuel Riel 9ab0a095ab Add --rsh command line option to complement BORG_RSH env var. Fixes #… (#4290)
Add --rsh command line option to complement BORG_RSH env var. Fixes #1701
2019-01-31 13:54:17 +01:00
Manuel Riel 7e7d74c1c1 Add new FAQ regarding change of compression settings. Fixes #4222 (#4282)
FAQ regarding change of compression settings. Fixes #4222
2019-01-31 05:58:33 +01:00
Manuel Riel 4ecc7ede8d Add note about BSD flags to changelog. Fixes #4246 (#4279)
Add note about BSD flags to changelog. Fixes #4246
2019-01-31 05:56:37 +01:00
Manu b37aceb469 Add FAQ regarding free disk space check. Fixes #3905 2019-01-31 12:45:41 +08:00
Manu d13ddb224a Update BORG_PASSCOMMAND example and clarify variable expansion. Fixes #4249 2019-01-30 10:12:47 +08:00
step21 a577a63313
Added vorta gui 2019-01-05 21:07:28 +01:00
Greg Grossmeier b311b62e0d Docs: Improve logging in example automation script (#4226)
docs: improve logging in example automation script

* add an info entry for the compacting step
* add a final info entry for successful completion
2018-12-21 18:54:58 +01:00
Thomas Waldmann 2864fb781c update changelog about removed deprecated stuff 2018-12-11 23:55:29 +01:00
Thomas Waldmann fc6e81c8bb docs: --format is required for some expensive-to-compute values
borg list by default does not compute expensive values except when
they are needed. whether they are needed is determined by the format,
in standard mode as well as in --json mode.
2018-12-07 01:18:32 +01:00
Thomas Waldmann 02f3c80d83 docs: tell that our binaries are amd/intel, bauerj has ARM
(cherry picked from commit 13986a1a6a)
2018-12-07 00:51:51 +01:00
James Vasile 806d937c2e 4081 - Add note about files changing during backup (#4116)
Add note about files changing during backup
2018-11-01 21:11:05 +01:00
Łukasz Stelmach 548355125e read a passphrase from a file descriptor
Read a passpharase from a file descriptor specified in the
BORG_PASSPHRASE_FD environment variable.
2018-09-21 09:11:39 +02:00
newtonne 11a2f1f684 Remove row/column-spanning from docs source, fixes #4000
Sphinx doesn't support row or column-spanning, which caused the content
of the additional features table to be incorrect. To fix this, we now
define the content of each cell explicitly.

This change also fixes #3990.
2018-08-09 20:38:46 +01:00
Thomas Waldmann 8a09f26712 remove zeromq or python 3.5 references 2018-08-06 17:52:08 +02:00
Thomas Waldmann 90348c1de9 add BORG_HOST_ID, fixes #3985 2018-08-04 15:01:48 +02:00
James Rowell 34227430d4 Installation from source - setting python interpreter version (#3995)
explicit instructions for setting python interpreter when installing from source via git
2018-07-29 09:50:09 +01:00
Marvin Gaube 2a4ed3f0e8 Note regarding borg version (#3987)
add a note regarding in-file checkpointing and borg versions
2018-07-20 16:25:16 +02:00
Thomas Waldmann 318cfffde1 update CHANGES about compaction changes 2018-07-14 19:15:09 +02:00
Thomas Waldmann a8d52351bb update man pages / usage docs 2018-07-14 14:56:29 +02:00
Thomas Waldmann e6fcf4ea42 update docs about separated compaction 2018-07-14 14:53:23 +02:00
Thomas Waldmann 3fd6bd8ca7 update CHANGES: added 1.1 history (master) 2018-07-08 00:18:09 +02:00
Thomas Waldmann a89aadc9f2 update CHANGES (master) 2018-07-08 00:13:13 +02:00
Russell Davis 041f1baf4c
Update installation instructions for macOS
- Updated `OS X` to the new `macOS` name
- Fuse 3.x is no longer just a prerelease
- Added instructions to install fuse via homebrew
2018-07-06 18:46:18 -07:00
lumbric bbd1533c99 docs: add link to tempfile module
Linking tempfile docs helps to figure out, which default value might be
used, if TMPDIR is not set.
2018-06-25 20:32:44 +02:00
Saurav Sachidanand b3c1104760 Update docs on deleting multiple archives 2018-05-27 09:38:23 +05:30
TW 485368d50d
docs: fix and deduplicate encryption quickstart docs (#3776)
docs: fix and deduplicate encryption quickstart docs

just refer to "borg init" docs rather than duplicating it in quickstart.

also: s/archive/repository/
2018-05-23 14:17:01 -07:00
Thomas Waldmann d94bd22740 BORG_SHOW_SYSINFO=no to hide system information from exceptions
Can be used:
- in case of troubles with the sysinfo code
- by borg backup providers who do not want to show system information

(cherry picked from commit 64aaec6628)
2018-05-18 18:49:56 +02:00
infectormp 8f6be74993 Add note from borg with-lock about copy repo (#3749)
docs: Improve FAQ about copying a repo
2018-04-19 15:34:11 +02:00
infectormp 60f9849336 docs: Improve borg with-lock (#3780)
docs: improve borg with-lock, link to FAQ
2018-04-19 15:29:47 +02:00
André-Patrick Bubel 1ba0e85621
docs: describe what BORG_LIBZSTD_PREFIX does 2018-04-16 19:12:01 +02:00
TW b2c141899b
Merge pull request #3710 from ThomasWaldmann/docs-security-fingerprinting
security: describe chunk size / proximity issue, see #331
2018-03-24 21:50:17 +01:00
TW b6b8e1bb16
Merge pull request #3683 from milkey-mouse/repo-archive-quickstart
Add quickstart introduction to repositories & archives (fixes #3620)
2018-03-24 21:31:27 +01:00
Milkey Mouse d41c9296c0
fixup! Add quickstart introduction to repositories & archives (fixes #3620) 2018-03-24 12:05:47 -07:00
Thomas Waldmann 8ac272f35f security: describe chunk size / proximity issue, see #3687 2018-03-23 17:54:02 +01:00
TW 201c62430a
Merge pull request #3675 from ThomasWaldmann/crypto-compression-docs
security docs: add about combining compression and encryption
2018-03-17 19:46:42 +01:00
TW c206f8b403
Merge pull request #3677 from ThomasWaldmann/docs-avoid-permission-mixup
quickstart: add note about permissions, borg@localhost, fixes #3452
2018-03-12 15:18:16 +01:00
TW 6b3191a285
Merge pull request #3678 from ThomasWaldmann/docs-log
docs: improve logging docs, fixes #3549
2018-03-12 15:16:47 +01:00
TW e6978fa2ea
Merge pull request #3680 from ThomasWaldmann/transaction-rollback-docs
docs: extend append-only repo rollback docs, fixes #3579
2018-03-12 15:13:53 +01:00
Milkey Mouse 09beb64f34
Add quickstart introduction to repositories & archives (fixes #3620) 2018-03-10 17:19:46 -08:00
Thomas Waldmann 451b22ee51 docs: extend append-only repo rollback docs, fixes #3579 2018-03-09 23:27:31 +01:00
Thomas Waldmann 99be106bc8 docs: improve logging docs, fixes #3549 2018-03-09 20:44:20 +01:00
Thomas Waldmann 7bc2138dcb quickstart: add note about permissions, borg@localhost, fixes #3452 2018-03-09 20:01:38 +01:00
TW 1473ea708c
Merge pull request #3526 from borgbackup/enkore-patch-1
sec docs: explicitly note what happens OUTSIDE the attack model
2018-03-09 18:49:32 +01:00
Thomas Waldmann be8913a93c security docs: add about combining compression and encryption 2018-03-09 18:02:57 +01:00
Thomas Schwinge 2458035057 Mark up Unicode string
Running Sphinx v1.4.8
    WARNING: the config value 'copyright' is set to a string with non-ASCII characters; this can lead to Unicode errors occurring. Please use Unicode strings, e.g. u'Content'.
    [...]
    Encoding error:
    'ascii' codec can't decode byte 0xc3 in position 23: ordinal not in range(128)
2018-03-08 11:37:45 +01:00
Josh Holland 9f2f4132ec
Improve formatting of GPG output in documentation 2018-03-05 13:21:20 +00:00
Michael Gajda 74a3058abc Add docs on how to verify a signed release
Short howto on using gpg to verify a signed binary release.
Fixes #3634
2018-03-02 21:40:42 +01:00
Jesus Fernandez Manzano 3a0ae9c7f3
[Docs] Update quickstart.rst to fix typo 2018-02-26 10:58:31 +01:00
TW 24b0bcb461
Merge pull request #3589 from Gu1nness/docs
A few documentation fixes for Documentation issue 19
2018-02-10 11:31:19 +01:00
Rémi Oudin 88972d7d81 Better formatting of CPU usage documentation
This is now displayed as a list, with bold fonts for each bullet.
Refers https://github.com/borgbackup/borg/issues/3554
2018-02-03 17:34:45 +01:00
Alexander 'Leo' Bergolth 74c10e4643 add chunker_params to archive info (at least to json output) 2018-01-25 21:02:39 +01:00
enkore 674ce72fda sec docs: explicitly note what happens OUTSIDE the attack model 2018-01-10 15:30:12 +01:00
TW 4b98393542
Merge pull request #3520 from pngwjpgh/doc/chunk-seed
Chunk seed is generated per /repository/
2018-01-10 07:26:26 +01:00
Gregor Kleen 1820e22c02 Chunk seed is generated per /repository/ 2018-01-09 18:17:46 +01:00
Gianfranco Costamagna 0980d6ac43 fixup allows one to, with suggestions from Dan Christensen 2018-01-03 15:54:52 +01:00
Gianfranco Costamagna 111a19f7fa fix typo: allows to -> allows one to 2018-01-03 11:42:38 +01:00
Gianfranco Costamagna 1a74326b5a borg: fix typo: explicitely -> explicitly 2018-01-03 11:42:30 +01:00
Abogical 937736ceb9 Happy new year! 2018-01-02 11:10:07 +02:00
Thomas Waldmann c5a339384e added BORG_BASE_DIR, s/get_home_dir/get_base_dir/g, docs, fixes #3338
also: sorted env var docs by level
2017-12-23 01:42:18 +01:00
Josh Holland 95a05dbbf1
docs: Fix missing apostrophe 2017-12-22 21:44:12 +00:00
Thomas Waldmann 2588e50f0b readme / docs: mention zstd 2017-12-18 22:55:00 +01:00
Thomas Waldmann 061321b668 update requirements and install docs about bundled lz4 and zstd 2017-12-18 22:55:00 +01:00
Thomas Waldmann fe48caf853 fix lz4 deprecation warning, require lz4 >= 1.7.0 (r129)
as we bundle lz4 1.8.0 now, platform not having a recent liblz4 can
now just use the bundled code.
2017-12-18 00:53:26 +01:00
Thomas Waldmann 9b6924d27f rename BORG_LZ4_PREFIX env var to BORG_LIBLZ4_PREFIX
consistency:
we also have BORG_LIBB2_PREFIX and BORG_LIBZSTD_PREFIX.
2017-12-18 00:53:26 +01:00
Thomas Waldmann c8b2820225 bundle lz4 1.8.0 src code, license 2017-12-15 06:33:04 +01:00
Thomas Waldmann dc883f62ae bundle zstd 1.3.2 source code
only .c and .h files + license
2017-12-15 00:29:26 +01:00
Thomas Waldmann d81ea0321d git add docs/man/borg-config.1 2017-12-13 04:40:20 +01:00
Gregor Kleen 85fb38e2f3 Add placeholder for fqdn in reverse notation 2017-12-11 23:00:38 +01:00
Thomas Waldmann ce92960c63 add auto-generated docs for borg config
also: move a bit upwards in the use docs
(cherry picked from commit 278ed640e9)
2017-12-09 13:43:36 +01:00
Thomas Waldmann 209bf2dc24 move 3rd party docs/license file from package dir to docs/3rd_party
setup.py excludes all .c .h .pyx files from installation, but such
docs / license files would still be copied to the target directory
if they are inside the python "borg" package dir.

(cherry picked from commit 831a06a07d)
2017-12-02 18:13:11 +01:00
Thomas Waldmann 63bdae8314 docs: fix broken links
(cherry picked from commit c7994b598b)
2017-11-27 00:00:46 +01:00
Thomas Waldmann c2521a7759 link to the homepage for support/service
otherwise people ONLY reading the docs (and not coming from the
homepage) will miss these options.

(cherry picked from commit 7438cb2ef4)
2017-11-26 23:37:04 +01:00
Michael Rupert 6dd54f93ce fixed support links (#3379)
fixed support links
2017-11-26 05:10:22 +01:00
Thomas Waldmann 0eaec60384 docs: give examples for borg mount exclusion options 2017-11-25 20:18:59 +01:00
Thomas Waldmann 91ff2f81a6 docs: move bsdflags tuning comments to notes docs section
the atime comments are already there.
2017-11-25 20:08:33 +01:00
Thomas Waldmann a107233f75 docs: document birthtime support on platforms supporting it
stat.st_birthtime, MacOS and (some?) BSDs.
2017-11-25 19:51:33 +01:00
Thomas Waldmann e3cb7c3c32 docs: document good and problematic option placements, see #3356 2017-11-25 19:46:48 +01:00
Thomas Waldmann f2a1539f25 docs: fix examples with problematic option placements, fixes #3356
have options to the left OR to the right of all positional arguments,
but not on BOTH sides and not in between them.
2017-11-25 19:29:34 +01:00
Thomas Waldmann ef8217afc9 build_man (master)
also: git add borgfs.1
2017-11-25 14:38:04 +01:00
Thomas Waldmann 73fac09dda build_usage (master)
also: add new borgfs.rst.inc
2017-11-25 14:35:52 +01:00
Michael Rupert 71fbac94fb Moved Support to .org (#3360)
docs: moved support options to www.borgbackup.org
2017-11-25 03:15:18 +01:00
TW c5dc75ae23
Merge pull request #3312 from milkey-mouse/borg-config-cmd
Add borg config command
2017-11-24 16:56:15 +01:00
Milkey Mouse 5b47cf6fa5
Add borg config command (fixes #3304)
This command works similarly to "git config" - it parses repo and
cache configs to get, set, and delete values. It only works on local
repos so a malicious client can't e.g. override their storage quota
or reset the append_only flag.

Add tests for borg config

Add documentation for borg config

Change manual config edits -> borg config

There were a couple places in the documentation where it was advised
to edit the repository or cache config file, a process that is stream-
lined by borg config.
2017-11-23 14:51:54 -08:00
TW 483d3e8a8b
Merge pull request #3292 from milkey-mouse/document-ntfsclone
Add instructions for using ntfsclone
2017-11-23 22:07:15 +01:00
Milkey Mouse c0edc60ca6
Move image backup-related FAQ entries to a new page 2017-11-23 12:14:35 -08:00
Milkey Mouse 759c8f77cf Mention break-lock in checkpointing FAQ entry (#3340)
Mention break-lock in checkpointing FAQ entry, fixes #3328
2017-11-20 23:18:37 +01:00
TW 22ae15f5b4
Merge pull request #3327 from anarcat/faq-remove
add FAQ about removing old files and policies
2017-11-18 21:01:31 +01:00
Milkey Mouse 7cb36a20b4 Document sshfs rename workaround (fixes #3315) (#3325)
Document sshfs rename workaround, fixes #3315
2017-11-18 20:57:39 +01:00
Antoine Beaupré 1a2906ae7e add FAQ about removing old files and policies
This has been asked twice already this year:

https://mail.python.org/pipermail/borgbackup/2017q3/000796.html
https://mail.python.org/pipermail/borgbackup/2017q4/000891.html

... and I was asked again privately today, so this qualifies as FAQ to
me.
2017-11-18 09:08:37 -05:00
TW b8dece0ae7
Merge pull request #3290 from milkey-mouse/borgfs-man
Generate usage & man page for borgfs
2017-11-12 16:41:54 +01:00
Tom Denley c6591a7c06 Correct usage of "fewer" in place of "less" 2017-11-11 11:21:45 +00:00
Milkey Mouse b0d68036c2
Add instructions for zerofree 2017-11-10 11:54:45 -08:00
Milkey Mouse 2b254abb39
Add instructions for ntfsclone (fixes #81) 2017-11-10 11:54:45 -08:00
Milkey Mouse 17d5c794d3
Generate man page for borgfs (fixes #3216) 2017-11-10 11:25:19 -08:00
Milkey Mouse 7b485c23f7 Clarify create --stats duration vs. wall time (fixes #3301) (#3303)
clarify create --stats duration vs. wall time, fixes #3301
2017-11-10 17:44:34 +01:00
Thomas Waldmann 818b61935b update release checklist about security fixes 2017-11-06 10:38:04 +01:00
TW febb7ffca8
Merge pull request #3288 from ThomasWaldmann/doc-updates2
Doc updates 2
2017-11-05 22:18:41 +01:00
Thomas Waldmann e7fd1ff2ee docs: more than 23 is not supported for CHUNK_MAX_EXP, fixes #3115 2017-11-05 21:35:58 +01:00
Thomas Waldmann 61d6c58241 update / rephrase cygwin / WSL status, fixes #3174 2017-11-05 19:24:49 +01:00
TW ddecd4b618
Merge pull request #3182 from TBurchfield/master
Removal of |project_name|.
2017-11-01 02:41:02 +01:00
TW c640e3815b
Merge pull request #3236 from narendravardi/borg_config_dir_documentation
Added documentation for BORG_CONFIG_DIR
2017-10-30 06:49:43 +01:00
narendravardi 764a62f42c Added documentation for BORG_CONFIG_DIR 2017-10-29 21:52:33 +05:30
Milkey Mouse 87a9952f3b
Clarify using a blank passphrase in keyfile mode 2017-10-25 19:42:02 -07:00
Svein Ove Aas 98443f15d5 Add Nix/NixOS install command 2017-10-20 17:08:10 +01:00
8bit 8d830d069f Removed all |project_name
| instances, replaced with Borg
2017-10-17 11:50:55 -05:00
Thomas Waldmann e674822888 remove hardlinked symlinks warning, update docs, fixes #3175
the warning was annoying for people with a lot of such items and
they can not do anything about it anyway.

thus, just document this as a limitation.
2017-10-17 18:34:32 +02:00
Thomas Waldmann ed1a8b5cf1 add example showing --show-version --show-rc 2017-10-12 06:03:12 +02:00