Minarca
Self-hosted opensource data backup for Linux, Windows and Mac. Git mirror of https://gitlab.com/ikus-soft/minarca
Install / Use
/learn @ikus060/MinarcaREADME

Minarca is a free and open-source backup software providing end-to-end integration to put you in control of your backup strategy. This Self-Hosted software may suit the needs of service providers or small business.
Simple to install, to configure and to manage, Minarca will not waste your time. Minarca makes user data easily accessible by providing a rich web interface to recover the files.
Minarca client may be used to simplify the integration of new computers running Windows or Linux Debian. It's user interface and command line interface allow simple usage for desktop users or headless servers. Minarca also keep interoperability with legacy installation of rdiff-backup.
Based on rdiffweb, Minarca Server may be used to browse, restore your data easily with a convenient web interface accessible from everywhere.
Features
| Powerful web interface | Backup to multiple destination | Self Hosted |
|---|---|---|
|
|
|
|
| Windows Agent | Linux Agent | MacOS Agent |
|---|---|---|
|
|
|
|
Getting started
Check how Minarca is working without installing the server. We have setup a testing environment for you. You may login to https://test.minarca.net/ using the default username / password: admin / admin123
Then start a backup in few minutes by installing minarca client for Linux/Debian, Windows or MacOS.
Download & Install
Minarca Agent Installation steps
Minarca Server Installation steps
Pre-releases
We provide the ability to easily test future versions without having to compiling from source.
Minarca Agent can be downloaded from our archive: https://www.ikus-soft.com/archive/minarca/
Minarca Server can be install using our APT Dev repository:
curl -L -o /etc/apt/keyrings/minarca-keyring.asc https://www.ikus-soft.com/archive/public.asc
cat <<EOF > /etc/apt/sources.list.d/minarca.sources
Types: deb
URIs: https://nexus.ikus-soft.com/repository/apt-release-$(lsb_release -sc)/
Suites: $(lsb_release -sc)
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/minarca-keyring.asc
EOF
apt update
apt install minarca-server
Newsletter
Subscribing to our newsletter is an effective way to stay up-to-date on the latest news about Minarca. By signing up for, you will receive regular updates and notifications about new features, updates, and releases related to Minarca.
Documentation
Want to know more about Minarca and learn it thoroughly? Read our complete documentation.
Contribution
Thank you for considering contributing to Minarca Data Backup! There are several ways you can contribute to the project:
-
Report bugs: If you find any issues with the software, please let us know by opening a new issue on our Gitlab repository. Be sure to include as much detail as possible, such as the steps to reproduce the bug and any error messages you receive.
-
Provide translations: We are always looking to improve the accessibility of our software by supporting multiple languages. If you are fluent in a language that is not currently supported, we would greatly appreciate your help in translating the software.
-
Support more architectures: We are looking to expand our support to more architectures, such as ARM for Raspberry Pi devices. If you have experience with these platforms and are interested in helping, please reach out to us.
-
Support for NAS technology: We are targeting NAS devices as an easy deployment option for the Minarca Central server such as TrueSCALE. If you have experience with these devices and would like to help us with development, please let us know.
-
Provide RPM packages: We currently do not have support for RedHat Linux distributions. If you have experience with building RPM packages and are interested in helping us support this distribution, please reach out to us.
We welcome all contributions to the project and appreciate any help you can provide.
You need help?
Community support
If you have any questions or need assistance, feel free to reach out to the Minarca community:
- Join the Minarca Google Group to ask questions, share ideas, or get help from the community.
Professional support
Professional support for Minarca Data Backup is available by contacting IKUS Soft.
Support Us Through Github Sponsorship
We are passionate about developing and maintaining this open-source project to make it better with each update. Your support can help us continue our efforts and enhance the project for the entire community. By becoming a Github Sponsor, you directly contribute to the project's sustainability and growth.
About Minarca
Minarca Server is written in Python and is released as open source project under the GNU AFFERO GENERAL PUBLIC LICENSE (AGPLv3). All source code and documentation are Copyright IKUS Software inc. support@ikus-soft.com
Minarca Server is actively developed by IKUS Software inc. since April 2015.
The Minarca Server source code is hosted on Gitlab and mirrored to Github.
The Minarca website is https://minarca.org/.
Changelog
6.1.2 (2025-06-25)
Bug Fixes
- fix(macOS): prevent duplicate entries when adding a file
6.1.1 (2025-06-20)
Bug Fixes
-
Improved warning handling:
- Warnings are no longer ignored
- Warnings are now captured and logged
- Downgraded
setuptoolsto suppresspkg_resourceswarnings
6.1.0 (2025-06-13)
New Features
- Add support for Debian Trixie.
- Add support for Ubuntu Plucky 25.04.
- Add support for Python 3.11 and 3.12.
- Allow manual-only backup schedule.
- Add pre/post command hook support per backup job (#73).
- Add support for kdialog to support KDE (#292).
- Include pattern to backup MacOS Mail.
- Include pattern to backup MacOS Messages (SMS).
- Assign error codes to all exceptions and generate related documentation (#207).
- Include REST API endpoints documentation.
- Generate CLI documentation automatically using argparse.
Improvements
- Review file restore interface:
- Merge custom and full restore.
- Support multi-file/folder selection.
- Restore in-place or to subfolder.
- Add search/filter functionality.
- Adjust log view:
- Improve log loading performance.
- Change refresh rate.
- Truncate overly long logs to prevent delays.
- Increase scrollbar width for better usability.
- Backup Behavior:
- Schedule backups even on battery (Windows) (#273).
- Improve exception logging (e.g.,
BackupError). - Provide error message details on command line.
- Exclude iCloud Trash by default #314.
- Exclude Office temporary files by default.
- Security/Connectivity:
- Use OS Certificate for HTTPS #309.
Bug Fixes
- Fix error handling of
EDEADLKfor backup from MacOS to Linux (Handle Cross-Platform OSError.errno Mismatch). - Provide details on SSL Error #309.
- Fix state of "Run whether the user's session is open or not" when user cancel crendential #290.
- Cancel clock event when switching to new view, because KivyMD is not taking care to cancel them when widget get deleted (Handle weakref left over by KivyMD).
- Fix
minarcawstartup. - Avoid "cannot start process when it's already running" when running as cronjob #291.
- Fix subprocess streaming to prevent losing output.
- Fix license file creation on Windows pyinstaller.
Internal Changes
- Lazy-load views to improve startup time.
- Use lazy import to reduce memory footprint and improve loading time.
- Upgrade Kivy to version 2.3.1.
- Remove coding header.
- Update copyright year to 2025.
- Add missing copyright.
- Add check to tox.ini to verify copyright.
- Make unit test more stable.
- Add
openssh-clientas dependency on Linux. - Disable
mtdevlookup on Linux. - Disable use of system wide ssh config file on Linux and MacOS #274
