kees-z / duplicatidocs Goto Github PK

Based in this issue and my personal experience, it is a common requirement/desire to run the Duplicati WebUI behind a reverse proxy.

Would it be an idea to add this to the documentation? I can do it, I just need me pointers on which is the best section to add this to. At the end of the installation section could be an option.

Cheers,
Nicola

Hey,

I looked at this documentation and noticed the paramater --gcs-storage-class in the Google Cloud section.

Is there an error, because I don't guess those regions are the storage class types?
If you confirm this error, I would create a pull request with the correct values.

Reference: https://cloud.google.com/storage/docs/storage-classes

Top of all pages : Edit on squidfunk/mkdocs-material is a dead link

03-usingGUI/#creating-a-new-backup-job
Last § before the Note : ...selecting Import from a file in the Add backup menu. N the next step you can browse... should be ...backup menu. In the next...

04-using-CLU
2 dead links to Storage Providers (was a chapter, moved to a new page)
1 dead link to Advanced Options (was a chapter, moved to a dedicated page)

/07-other-CLU/#duplicaticommandlinerecoverytoolexe
Dead link to Disaster Recovery (was a chapter, moved to a specific page)

08-Disaster recovery:
...problems it finds, but is there is significant damage should be but if there is

Great soft guys, keep on !

Would be nice to make this informations available for non english speaking people.

I could help with a German translation.

OS: Windows 10 Version 22H2 (Build 19045.3570)
Duplicati version: 2.0.7.1_beta_2023-05-25
Browser: Vivaldi 6.1.3035.204 (Stable channel) (64-bit)

Steps to reproduce:

1. UI Menu "Add backup" -> "Next" button
2. On the General tab:
   • Name: "test backup"
   • Click "Generate" link to generate Passphrase
   • Click "Next" button
3. On the "Destination" tab:
   • Click "Manually type path"
   • Folder path: C:\tmp_dest1\
   • Add Advanced option alternate-target-paths with value C:\tmp_dest2\
   • Click "Next" button
4. On the "Source data" tab:
   • Add any existent source folder with files e.g. C:\tmp_source\
   • Click "Next" button
5. On the "Schedule" tab:
   • Uncheck "Automatically run backups." checkbox
   • Click "Next" button
6. On the "Options" tab:
   • Click "Save" button
7. Click on the created backup "test backup" and then "Edit" link
8. Click "Destination" tab and then "Advanced options"

Expected result:

alternate-target-paths option is present on UI with C:\tmp_dest2\ value

Actual result:

alternate-target-paths option is not present

Notes:

• Although option is not visible on UI, the backup is working as expected.
• Exported json configuration file contains alternate-target-paths with correct value
• When fill destination path with tmp_dest1\ value (instead of C:\tmp_dest1\) during the new backup creation then alternate-target-paths is present on UI as expected
• Although backup is working as expected, after re-saving backup option alternate-target-paths will be lost

Creating a new backup job

The retention can be set in 3 ways

should cover Smart backup retention and Custom backup retention. Here one sees smart is just a reasonable preconfigure of 1W:1D,4W:1W,12M:1M which custom can vary from. The help text shows this only by description. Not sure what manual should do.

I'm also not decided if hours minutes and seconds (h m s) should be mentioned or are too obscure. One time that hours is useful is when someone likes having one backup per day kept, e.g. they use Smart backup retention, and they backup once per day. Any timing variations may delete one that follows the previous by, say, 23 hours and 59 minutes (or worse if they run manual backups). This "skip" winds up looking like one every other day, so is pretty obvious and a bit unsettling, and invites forum topics asking why.

Some people also take terminology like days and weeks as a calendar, but it's not. All larger terms wind up converting into seconds. This is especially obvious in the paragraph above, where a common backup frequency (daily) bumps into a sensible retention policy (daily). It seems that complaints about years, months, and weeks not following a calendar are rare to none. How to document time?

Occasionally some people don't quite understand how time frames work, so try to make them one after another instead of nesting. Sometimes I've tried to use the term "age" to throw in a common term. A diagram (shaded for backup "density"?) might be helpful.

Another thing whose documentation varies even in help is U. Command line help says it can "indicate an unlimited time interval", which is confusing because there were two concepts "time frame" and "interval" defined, so which one takes a "U"? I think both do.

From a time frame perspective, one might use it to mean "unlimited time frame" which implicitly means "beyond the largest specific time" because time frames are sorted. This also prevents implied delete beyond the largest time frame (see topic below). For interval, there is no minimum interval. I sometimes use language like "spacing" and "thinning" in forum posts,, but this is all tough to explain completely. I suspect lots of people just see "Smart" in the GUI and pick it without much thought, which is actually reasonable to do.

People who actually think this through thoroughly may realize (or may be told in the forum) that a file which exists (between creation and deletion) for a time less than current minimum interval (which can increase with time) may disappear completely. This may matter to some people, but there's a limited amount that can be said. Would it be better to have an "advanced" section for those wanting it?

Removing files from backup is a recent forum topic pointing to big 2017 topic that predated the early 2018 changes. Links provided, and there are a lot more. It would be nice to get this in the manual. If need be, maybe staff can discuss a draft? Is markdown similar?

Whatever is said probably deserves some verification testing, and I suspect some coded help text might also merit an upgrade if a good way to explain retention policy can be determined. Maybe the manual can take the lead, then let that guide the other spots.

Links in disaster recovery broken:

https://duplicati.readthedocs.io/en/latest/08-disaster-recovery/

Not working:

• Restoring files from a backup
• Restoring files if your Duplicati installation is lost

I noticed that Duplicati is capable of taking database backups in the web application but didn't find any documentation about this feature at all.

Also I struggled configuring my backup job correctly on a server on which also a MS SQL Server is running until I found out that I have to add the Guid of the "SQL Server VSS Writer" to --vss-exclude-writers. Putting this Guid here prevents full backups of the SQL Server databases being triggered by the backup job (what would break the full-diff-log backup chain of a database maintained by SQL Server itself or by other tools). It would be great to cover this topic also in more detail in the docs.

I'm currently reviewing backup options and noticed that although WebDAV is used in this guide:
https://www.duplicati.com/articles/Getting-Started/#choose-how-to-add-the-backup

it isn't listed in the docs:
https://github.com/kees-z/DuplicatiDocs/blob/master/docs/05-storage-providers.md

Looking at the code it seems supported, so I'm not worried. As I haven't had any experience with the program so far, I'm raising this as an issue instead of a PR.

It would be helpful to document a basic Docker installation. We should mention important details such as mapping volumes to preserve configuration settings, and how to publish ports to provide access to the web interface. There are some posts in the forums that summarize the basics pretty well.

https://forum.duplicati.com/t/how-to-install-duplicati-on-synology-dsm/5145

The Docker main page documents some of this (and more) already, and although it would duplicate the effort it would be nice if more of the documentation could be found in a single place.

As in another issue, I had some trouble deciphering why Duplicati was not reacting to my commandline. There was no console output indicating an issue, so I turned to increasing the log level.

I tried the following, to get any output:

• --log-level Debug
• --log-level 4
• --log-level dasfadsfdafs <-- I expected an error in parsing the log level, which hopefully would provide me with valid values

I finally read the source code and found the valid values here.

For this request, I hope that these values could be documented such that future users won't have to guess :).

I'll also make an issue with Duplicati on outputting an error when invalid values are provided.

https://duplicati.readthedocs.io/en/latest/05-storage-providers/#azure-blob

I have tried these commands:

docker exec -u 0 -it duplicati duplicati-cli backup azure://containerbackuptest/$(date -I) /databases --azure_account_name sillybackuptest

results in "System.IO.IOException: The source folder sillybackuptest does not exist, aborting backup"

docker exec -u 0 -it duplicati duplicati-cli backup --azure_account_name sillybackuptest azure://containerbackuptest/$(date -I) /databases

results in "The supplied option --azure_account_name is not supported and will be ignored" and "System.IO.IOException: The source folder azure://containerbackuptest/2019-04-16 does not exist, aborting backup".

An example would be great, you know, an actual command you can run to put something in a blob container.

(I should note that it works fine for just making a file backup.)

Lists all added / removed / changed files instead of summarized version.

Also suited for 06-advanced-options.md

--verbose seems outdated, OTOH.

Hi,

I'm trying out duplicati for a linux server, and I was having trouble defining my setup. Turns out that arguments like --webservice-port 8200 did not get read, they had to be in the form --webservice-port=8200.

I recommend adding that as a note in the top of this page, or maybe by adding examples to each commandline, like this:

It would immediately highlight to the reader that the expected form is with an equals sign.

I mean here: https://i.imgur.com/jlADh4T.png
Error received: https://i.imgur.com/EfBeLhp.png
Complete address in Chrome address bar: https://github.com/kees-z/DuplicatiDocs/edit/master/home/docs/checkouts/readthedocs.org/user_builds/duplicati/checkouts/latest/docs/03-using-the-graphical-user-interface.md

Hi all,
I'm using Duplicati for my backups currently and I want to change y destination from Gdrive to Dropbox.

However it turns out, that apprently the OAUTH from Duplicati to Dropbox is not implemented properly as it only returns a SL (short-lived) token that expires after a couple of hours.

I haven't found a way to replace it with a proper token that doesn't expire. There is no config option in Duplicati itself and I tried to create my own app via Dropbox App Console.

I can hardly imagine that this behaviour is as expected? It would basically mean that there is no one out there, using Duplicati + Dropbox?

Code
Autorisation mit dem OAuth Service ist fehlgeschlagen: {"error_summary": "expired_access_token/.", "error": {".tag": "expired_access_token"}}.

Version: 2.0.6.2_experimental_2021-05-29

Any help is much appreciated.

Thanks

While ago I submited comit for 02-installation.md and it was accepted and I see those changes on github repo. But the website docs is not updated accordingly. Can you please update website version of the 02-installation.md to the version that is in github repo?

How do I uninstall Duplicati? Where are the uninstallation instructions? I'm using (Fedora) Linux. It would be useful to have the instructions in one place for all platforms!

Hi,
Thank you for the manual. First time user and I read it, before even downloaded.
However, it was kind of hard to understand the section with the startup and I was wondering if you're open for some suggestion
https://github.com/kees-z/DuplicatiDocs/blob/master/docs/02-installation.md

Cheers
Tido

When "Allow remote access" is enabled, access is only available by direct IP address or from the localhost by default. This is done in to help protect against DNS-based attacks. Users can specify hostnames that they want to grant access to.

While this is already mentioned in the user interface, it could be helpful to clarify this in the documentation as well.

This issue is a consequence of duplicati/duplicati#4316 - "python-is-python2 is deprecated and can break modern software #4316".

When that is solved, the manual should be changed so that the package python-is-python2 is NOT installed under Ubuntu (and possibly other linux versions). See the manual here: https://duplicati.readthedocs.io/en/latest/02-installation/ .

The 'python-is-python2' package is not directly mentioned in the Ubuntu commands, but it gets installed anyway. The following command in Terminal:

:~$ sudo apt install apt-transport-https sudo nano git-core python software-properties-common dirmngr

Gives this output (among a lot of other output of course):

Note, selecting 'python-is-python2' instead of 'python'

There are other things that need updating in the manual, as mentioned in https://forum.duplicati.com/t/installation-instructions-need-update/10459 .

Add this to the installationpart:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/debian raspbianbuster main" | sudo tee /etc/apt/sources.list.d/mono-official.list

sudo apt-get update

sudo apt-get install mono-devel

unfortunately there was still a library missing and I forgot to write it down. But the message was clear

Hi

I was just reading the installation instruction for ubuntu on https://duplicati.readthedocs.io/en/latest/02-installation/

I noticed that the installation instructions were outdated for ubuntu 20.04 and I submitted a PR for that #74
I believe that it should probably apply to older versions of ubuntu but I cannot verify this