Getting Started

Alpha Notice: Onesimus is under active development. This is a pre-release for testing and evaluation only — not for production use. Features may change, bugs are expected. Report issues on GitHub.

Download (Linux .deb)

A pre-built Debian package is available for quick testing:

# Download from GitHub Releases
wget https://github.com/Beerlesklopfer/Onesimus/releases/download/v0.2.0-alpha/onesimus_0.2.0~alpha_amd64.deb

# Install
sudo dpkg -i onesimus_0.2.0~alpha_amd64.deb
sudo apt-get install -f   # resolve dependencies if needed

Requirements: Debian 13 / Ubuntu 24.04+, Qt 6.8+, amd64

All releases: GitHub Releases


Build from Source

Prerequisites

Onesimus requires Qt 6.8+, CMake 3.16+, and a C++17 compiler. OpenSSL is included as a static submodule — no separate installation needed.

Linux

Install dependencies and build:

sudo apt-get install build-essential cmake git qt6-base-dev qt6-tools-dev qt6-tools-dev-tools perl
git clone https://github.com/Beerlesklopfer/Onesimus.git
cd Onesimus
./build.sh

The binary will be in build/onesimus.

Windows

Requires Visual Studio 2022 with C++ Desktop Development workload:

git clone https://github.com/Beerlesklopfer/Onesimus.git
cd Onesimus
.\build-windows.ps1

macOS

brew install qt@6 cmake
git clone https://github.com/Beerlesklopfer/Onesimus.git
cd Onesimus
./build.sh

First Connection

  1. Launch Onesimus
  2. The Connection Wizard will start automatically
  3. Enter your Bareos Director address and credentials
  4. Choose TLS-PSK or Certificate authentication
  5. Save the connection profile

You’re ready to manage your backups.

Build Options

OptionDescription
-t DebugDebug build with symbols
-sUse system OpenSSL instead of static
-cClean rebuild
-j4Parallel build with 4 jobs

See the full build documentation on GitHub.