/rdiffweb

A simplified backup management software for quick access to your archives through an efficient web interface.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Rdiffweb Banner

website • docs • community • demo

License Build Quality Gate Minarca Client Coverage

Welcome to Rdiffweb

Rdiffweb is a web application that allows you to view repositories generated by rdiff-backup. The purpose of this application is to ease the management of backups and quickly restore your data with a rich and powerful web interface.

Rdiffweb is written in Python and is released as open source project under the GNU GENERAL PUBLIC LICENSE (GPL). All source code and documentation are Copyright Rdiffweb contributors.

Rdiffweb is actively developed by IKUS Soft since November 2014.

The Rdiffweb source code is hosted on Gitlab and mirrored to Github.

The Rdiffweb website is https://rdiffweb.org/.

Features

With its rich web interface Rdiffweb provide a notable list of features:

  • Browse your backup
  • Restore single file or multiple files as an archived
  • Users authentication via local database and LDAP
  • Users authorization
  • Email notification when backup is not successful
  • Configurable repository encoding
  • Configurable retention period
  • Backup statistics visualization using graphs
  • SSH Keys management
  • Disk quota visualization
  • File and folder deletion

Demo

If you quickly want to check how Rdiffweb is behaving, you may try our demo server hosted on:

https://rdiffweb-demo.ikus-soft.com/

Use the following credential to login:

  • Username: admin
  • Password: admin123

Installation & Docker usage

For detailed installation steps, read the Installation documentation.

Current Build Status

Build Status

Download

You should read the Documentation to properly install Rdiffweb in your environment.

Docker

docker pull ikus060/rdiffweb

Debian

curl -L https://www.ikus-soft.com/archive/rdiffweb/public.key | apt-key add - 
echo "deb https://nexus.ikus-soft.com/repository/apt-release-bullseye/ bullseye main" > /etc/apt/sources.list.d/rdiffweb.list
apt update
apt install rdiffweb

Pypi

pip install rdiffweb

Support

Mailing list

Rdiffweb users should use the Rdiffweb mailing list.

Bug Reports

Bug reports should be reported on the Rdiffweb Gitlab at https://gitlab.com/ikus-soft/rdiffweb/-/issues

Professional support

Professional support for Rdiffweb is available by contacting IKUS Soft.

Changelog

Next Release - 2.5.0

This next release focus on multi-factor-authentication as a measure to increase security of user's account.

  • Store User's session information into database
  • Update ldap plugin to load additional attributes from LDAP server
  • Improve /status page error handling when session_statistics cannot be read
  • Add support for Ubuntu Jammy
  • Upgrade from Bootstrap v3 to v4 #204
  • Replace Fontello by Font-Awesome v4
  • Use CSS variables var() to customize themes
  • Remove usage of Jquery.validate
  • Replace custom timsort by jquery DataTables #205
  • Add Active Session managements #203
    • Active session should be visible in user's profiles
    • Active session may be revoked by user
    • Active session should be visible in administration view
    • Action session may be revoke by administrator
    • Show number of active users within the last 24 hours in dashboard
  • Handle migration of older Rdiffweb database by adding the missing repos.Encoding, repos.keepdays and users.role columns #185
  • Replace deprecated references of disutils.spawn.find_executable() by shutil.which() #208

Breaking changes:

  • Drop Ubuntu Hirsute & Impish (End-of-life)
  • session-dir is deprecated and should be replace by rate-limit-dir. User's session are stored in database.
  • previous .css customization are not barkward compatible

2.4.0 (2022-06-21)

This new release brings a lot of improvement since the last version, multiple bug fixes to make the application stable. A couple of new features to improve the overall usability and a new security feature to block a brute force attack.

  • Add RateLimit to login page and API to mitigate robots attacks #167
  • Send email notification only if email-sender option is defined to avoid raising exception in logs #176
  • Support file restore cancellation without leaving rdiffweb-restore process in <defunct> state #174
  • Replace python-ldap by ldap3 a pure python implementation to avoid dependencies on sasl and ldap binaries #186
  • Reffactor core module to allow better extendability and reusability #183
  • Add support for Debian Bookworm #180
  • Add support for Ubuntu Impish #175
  • Add rdiff-backup version to administration view
  • Run unit test during Debian build package
  • Refresh repository list automatically when required #188 #189
  • Fix error 500 displayed in status page #191
  • Improve repository browsing speed by minimizing the number of I/O call #192
  • Publish Docker image directly to DockerHub #144

Breaking changes:

  • Ldap Password changes is not supported anymore.
  • Ldap Check Shadow expire config is not supported anymore. It should be replace by a custom filter.
  • Drop CentOS 7 and CentOS 8 support

2.3.9 (2022-01-05)

Maintenance release to fix minor issues

  • Improve date parsing for backup.log to avoid printing exception in logs #170
  • Return HTTP error 403 for invalid symlink to avoid returning a misleading HTTP 500 Server Error #168
  • Show a user friendly error message when trying to create a new user with an existing username #169
  • Handle repository without last-backup date during the notification process to ensure notifications are sent #171
  • Replace CherryPy storage_type by storage_class to avoid warning in logs
  • Update code to avoid deprecation warning where applicable
  • Add Flake8 validation to improve code quality
  • Remove Ubuntu Groovy support

2.3.8 (2021-12-01)

  • Push all artefacts to nexus server including binaries and documentation
  • Fix Chart.js loading on Debian bullseye #164
  • Update installation steps documentation
  • Improve LDAP authentication to lookup entire directory
  • Fix usage of --ldap-add-user-default-userroot to avoid error related to wrong encoding
  • Improve authentication mechanics
  • Avoid raising an HTTP error 500 when login form receive invalid payload
  • Mitigate open redirect vulnerability in login form

2.3.7 (2021-10-21)

  • To avoid backward compatibility issue, revert CSRF Token validation
  • Mitigate CSRF vulnerability using cookies with SameSite=Lax
  • Mitigate CSRF vulnerability by validating the Origin header when a form is submited
  • Improve usage of WTForm for all form validation
  • Update installation stepd for debian #162
  • Build Ubuntu packages and publish them to our APT repo

2.3.6 (2021-10-20)

  • Broken build

2.3.5 (2021-10-18)

  • Mitigate CSRF vulnerability to user, ssh and repo management with CSRF Token

2.3.4 (2021-09-20)

  • Skip email notification if email-host configuration is not provided #157
  • Skip email notification when the new attribute value has the same value #159
  • USE LDAP mail attribute when creating new user from LDAP directory #156

2.3.3 (2021-09-10)

  • Provide a new theme blue to match IKUS Soft colors #158

2.3.2 (2021-09-07)

  • Automatically update user's repository list based on user's home directory

2.3.1 (2021-07-14)

  • Update default session-dir location to /var/lib/rdiffweb/session to avoid using /var/run #148

2.3.0 (2021-07-06)

  • Improve timezone handling to display date with local timezone using javascript #143
  • Improve charts by replacing d3js by chartkick #122
  • Replace the status view by something meaningful with chartkick #122
  • Provide Docker image with Rdiffweb docker pull ikus060/rdiffweb #55
  • Fix file and folder sorting #143

2.2.0 (2021-05-11)

  • Debian package:
    • Add rdiff-backup as dependencies to comply with Debian packaging rules
    • Multiple other fixed to control files
    • Use debhelper-compat (= 13)
    • Use debhelper-compat (= 13)
    • Run test during packaging
    • Create default folder /var/run/rdiffweb/sessions to store user session
  • Use ConfigArgPare for configuration to support configuration file, environment variables and arguments to configure rdiffweb #114
  • Fix cache in localization module
  • Add ldap-add-default-role and ldap-add-default-userroot option to define default value for role and user root when creating user from LDAP #125
  • Support PostgreSQL database by replacing our storage layer by SQLAlchemy #126
  • Fix to retrieve user quota only for valid user_root #135
  • Add option disable-ssh-keys to disable SSH Key management
  • Use absolute URL everywhere
  • Add support for X-Forward-For, X-Forward-proto and other reverse proxy header when generating absolute URL
  • Drop Debian Stretch support
  • Implement a new background scheduler using apscheduler #82
  • Use background job to send email notification to avoid blocking web page loading #47
  • Use background job to delete repository to avoid blocking web page loading #48
  • Allow deleting a specific file or folder from the history using rdiff-backup-delete #128
  • Improve support for session-dir #131
  • Add option admin-password to define administrator password for better security
  • Improve performance of repository browsing
  • Add a new view to display logs of a specific repository
  • Allow downloading the log
  • Define a default limit to graph statistics to make it display faster
  • Fix get-quota-cmd option to properly return a value

2.1.0 (2021-01-15)

  • Debian package: Remove dh-systemd from Debian build dependencies (https://bugs.debian.org/871312we)
  • Improve Quota management:
    • QuotaSetCmd, QuotaGetCmd and QuotaUsedCmd options could be used to customize how to set the quota for your environment.
    • Display user's quota in User View
    • Display user's quota in Admin View
    • Allow admin to update user quota from Admin View when QuotaSetCmd is defined.
    • Allow admin to define user quota using human readable value (e.g.: GiB, TiB, etc.)
    • Improve logging around quota management
  • Improve robustness when service is starting
  • Improve robustness when repository has wrong permission defined (e.g.: when some files not readable)
  • Add user id in Admin view
  • Replace UserObject(1) by the actual username in log file to improve debugging

2.0.0 (2020-12-04)

  • Re-implement logic to update repositories views to remove duplicates and avoid nesting repo. #107
  • Handle elapsed time of days in the graph. Thanks Nathaniel van Diepen contributions.
  • Rebrand all link to ikus-soft.com
  • Update documentation to install rdiffweb
  • Remove obsolete minify dependency
  • Drop support for python2
  • Provide null translation if translation catalogues are not found
  • Pass a LANG environment variable to rdiff-backup restore process to fix encoding issue #112
  • Remove obsolete python shebang
  • Remove execution bit (+x) on python modules
  • Provide --help and --version on rdiffweb executable
  • Improve cherrypy version detection
  • Do not update translation files (.mo) during build

1.5.0 (2020-06-24)

This minor release introduce official support of rdiffweb on Debian Bullseye. It also includes some usability improvements.

  • Change formatting of Last Backup date for "Updated 3 weeks ago" to ease the readability
  • Add support for Debian Bullseye
  • Add support for Python 3.8 (#104)
  • Add warning in the users list view when a root directory is invalid (#30)
  • Add options to control search depthness (#1)
  • Print a warning in the log when the "DefaultTheme" value is not valid (#90)

1.4.0 (2020-05-20)

Thanks to our sponsor, this release introduce a feature to have better control over the user's permission by defining 3 different levels of privilege: Admin, Maintainer and User. This addition allows you to have better control on what your users can or can't do.

  • Fix single repository discovery when a user's home is a rdiff-backup repository
  • [SPONSORED] Add a new setting at the user level to define the user's role. Admin, Maintainer and User. Admin are allowed to do everything. Maintainer are allow to browse and delete repo. Users are only allowed to browse. #94
  • Add "Powered by" in the web interface footer #91
  • Display a nice error message when trying to delete admin user #93
  • Introduce usage of wtforms and flash in admin users for better form validation. #96 #97
  • Update French translation

1.3.2 (2020-04-23)

This minor releases fixed issues found while testing release 1.3.0.

  • Fix lookup of executable rdiff-backup and rdiffweb-restore to search in current virtualenv first
  • Fix repository view when multiple repo path are conflicting
  • Fix logging of rdiffweb-restore subprocess

1.3.1 (2020-04-10)

This minor release enforces security of the password stored in rdiffweb database to make use of a better encryption using SSHA. Only new passwords will make use of the SSHA scheme.

  • Enforce password encryption by using SSHA scheme #88

1.3.0 (2020-04-07)

This release focuses on improving the restore of big archives. The download should be much faster to start. Major enhancement was made to offload the processing outside the web server. And all of this is still compatible with rdiff-backup v1.2.8 and the latest v2.0.0.

  • Restore file and folder in a subprocess to make the download start faster
  • Fix encoding of archive on Python3.6 (CentOS 7) by using PAX format
  • Add support to restore files and folders using rdiff-backup2
  • Remove obsolete dependencies pysqlite2
  • Fix issue creating duplicate entries of repository in the database

1.2.2 (2020-03-05)

This release provides little improvement to the v1.2.x including official support of rdiff-backup v2.0.0.

  • Enhance the repository to invite users to refresh the repository when the view is empty.
  • Support rdiff-backup v2.0.0
  • Deprecate support for cherrypy 4, 5, 6 and 7
  • Improve loading of repository data (cache status and entries)
  • Restore compatibility with SQLite 3.7 (CentOS7)

Known issues:

  • Filename encoding in tar.gz and zip file might not be accurate if you are running Python 3.6 (CentOS7)

1.2.1 (2020-02-08)

Little bug fix following the previous release

  • Fix 404 error when trying to access other users repo as admin
  • Fix logging format for cherrypy logs to matches rdiffweb format
  • Add log rotation by default

1.2.0 (2020-01-30)

This release focus on improving the database layers for better extendability to add more type of data and to support more databases backend like postgresql in the near future.

  • Add explicit testing for Debian Stretch & Buster
  • Change the persistence layers
    • Minimize number of SQL queries
    • Add object lazy loading
    • Add object data caching
  • Fix bugs with SQLite <= 3.16 (Debian Stretch)

1.1.0 (2019-10-31)

This release focus on improving the admin area and building the fundation for repository access control list (ACL).

  • Update documentation from PDSL web site
  • Improve the navigation bar layout
  • Update the login page headline
  • Update jinja2 version to allow 2.10.x
  • Show server log in admin area
  • Reduce code smell
  • Add System information in admin area
  • Validate credential using local database before LDAP
  • Reffactoring templates macros
  • Enhance user's view search bar
  • Change repository URL to username/repopath
  • Add System information in admin area
  • Improve testcases
  • Clean-up obsolete code
  • Fix issue with captital case encoding name
  • Fix compilation of less files
  • Fix google font import

1.0.3 (2019-10-04)

  • Removing the auto update repos

1.0.2 (2019-10-01)

  • Create "admin" user if missing
  • Update french translation

1.0.1 (2019-09-22)

  • Update installation documentation
  • Fix removal of SSH Key
  • Return meaningful error to the user trying to add an existing SSH key

1.0.0 (2019-09-11)

  • Make repository removal more robust
  • Improve performance of librdiff
  • Add new RESTful api
  • Return the right HTTP 401 or 402 error code for authentication
  • Fix bug introduce by upgrade to Jinja2 + python3
  • Store ssh keys in database and disk
  • Add support for theme (default, orange)
  • Remove deprecated profiling code
  • Add disk usage support / quota
  • Add support of cherrypy v18
  • Drop support of cherrypy v3.2.2
  • Add wsgi entry point
  • Replace the plugins architecture to ease implementation
  • Numerous bug fixes

0.10.9 (2019-05-22)

  • Better error handling when error.log file are not valid gzip file