Skip to content

Latest commit

 

History

History
185 lines (123 loc) · 7.06 KB

minarca-client.md

File metadata and controls

185 lines (123 loc) · 7.06 KB

Client Installation

System requirements

Minarca client could be installed on almost any hardware without restriction. You are limited to the following operating system.

  • Supported Operating System:
    • Windows 7 (64bits) - best effort support
    • Windows 10 (64bit)
    • Windows 11 (64 bits)
    • MacOS Catalina (Intel)
    • MacOS BigSur (Intel)
    • Debian Bullseye (64bit)
    • Debian Bookworm (64bit)
    • Ubuntu Jammy 22.04 LTS (64bit)
    • Ubuntu Lunar 23.04 (64bit)
    • Ubuntu Noble 24.04 LTS (64bit)
    • Ubuntu Oracular 24.10 (64bit)
    • Linux (64bit)

Installation Steps

Installation steps mostly depends on your operating system. Follow the step appropriate for your system.

Installation on Windows

On a Windows workstation, download the appropriate installer.

Minarca Client for Windows

Then launch the execution of the installer and follow the instructions.

Windows7: Your installation must be up-to-date or manually install VC 2015 Redistributable.

Installation on MacOS

On a Windows workstation, download the appropriate installer.

Minarca Client for Windows

Open the disk image and drag-n-drop Minarca to your Applications folder.

Open Minarca Disk image with Finder

Then open Minarca Application !

If you get the following, you might need to right click on Minarca Application and click "Open" to skip the certificate validation.

Minarca can't be open because Apple cannot check it for malicious software.

Installation on Ubuntu or Debian

On a Ubuntu or Debian workstation, download the appropriate installer.

Ubuntu

Minarca Client for Ubuntu Jammy

Minarca Client for Ubuntu Mantic

Minarca Client for Ubuntu Noble

Minarca Client for Ubuntu Oracular

Debian

Minarca Client for Debian Bullseye

Minarca Client for Debian Bookworm

On Debian workstation, it's preferable to install the packages using Gdebi.

Once installed, a shortcut to Minarca should be available on your desktop or start menu. Use it to start and configure Minarca.

Installation on Linux

For other Linux distribution, you may download a portable package.

Minarca Client for Linux

Extract it's content to a folder and launch minarcaw executable or minarca from command line.

Link your client with Minarca Server

Pre-requisite: You need to have a functional Mianrca Server deployed. You may use https://test.minarca.net which is made available for testing purpose.

From User Interface:

  1. Simply open minarcaw. If you have installed Minarca client you should be able to launch the client from your start menu.
  2. If Minarca is not yet linked to a server, a Setup dialog will be shown to allow you to configure Minarca with you server.
  3. You must provide the URL to you Minarca server, a username and password.
  4. You must also provide a repository name.

From Command line:

minarca configure -r REMOTEURL -u USERNAME [-p PASSWORD] -n NAME

Troubleshooting

When troubleshooting, it is essential to know where to find the logs, settings, and status files. The locations of these files differ depending on the operating system you are using: Windows, Linux, or macOS.

Windows

Windows Log File

The log file, which is essential for diagnosing issues, can be found at:

%LOCALAPPDATA%/minarca/minarca.log

Typically, %LOCALAPPDATA% defaults to %HOME%/AppData/Local.

Windows Settings Folder

The settings for Minarca are stored in the following directory:

%LOCALAPPDATA%/minarca/

Windows Status Folder

Status files, which help in understanding the current state of backups and other operations, are located at:

%LOCALAPPDATA%/minarca/

Linux

Linux Log File

On Linux systems, the log file is generally stored in the following directory:

$XDG_DATA_HOME/minarca/minarca.log

$XDG_DATA_HOME typically defaults to $HOME/.local/share.

Linux Settings Folder

The settings files are found in the configuration directory:

$XDG_CONFIG_HOME/minarca/

$XDG_CONFIG_HOME typically defaults to $HOME/.config/.

Linux Status Folder

Status files are stored in the following directory:

$XDG_DATA_HOME/minarca/

$XDG_DATA_HOME typically defaults to $HOME/.local/share.

Running as Root on Linux

If Minarca is running as root, the file locations change as follows:

  • Log File: /var/log/minarca.log
  • Settings Folder: /etc/minarca/
  • Status Folder: /var/lib/minarca/

MacOS

MacOS Log File

On macOS, the log file for Minarca can be found at:

$HOME/Library/Logs/Minarca/minarca.log

MacOS Settings Folder

The settings files are stored in the preferences directory:

$HOME/Library/Preferences/Minarca

MacOS Status Folder

Status files are found in the following directory:

$HOME/Library/Minarca

Customizing File Locations

On all platforms, it is possible to change the location of the settings and status folders using environment variables:

  • Settings Folder: Set the $MINARCA_CONFIG_HOME environment variable.
  • Status Folder: Set the $MINARCA_DATA_HOME environment variable.

Additional Tips

By knowing where to find these essential files, troubleshooting Minarca Data Backup becomes a more straightforward process. If you encounter issues that cannot be resolved through these files, consider reaching out to Minarca support with the log and status files for further assistance.