GitPedia

Zamba lxc toolbox

Zamba LXC Toolbox a script collection to setup LXC containers on Proxmox + ZFS. Zamba is the fusion of ZFS and Samba (standalone, active directory dc or active directory member), preconfigured to access ZFS snapshots by "Previous Versions" to easily recover encrypted by ransomware files, accidently deleted files or just to revert changes.

From bashclub·Updated May 25, 2026·View on GitHub·

Zamba LXC Toolbox is a collection of scripts to easily install Debian LXC containers with preconfigured services on Proxmox with ZFS. The main feature is `Zamba`, the fusion of ZFS and Samba in three different flavours (standalone, active directory dc or active directory member), preconfigured to access ZFS snapshots by "Windows Previous Versions" to easily recover encrypted by ransomware files, accidently deleted files or just to revert changes. The package also provides LXC container installer... The project is written primarily in Shell, distributed under the GNU General Public License v3.0 license, first published in 2021. Key topics include: debian, debian-buster, debian-scripts, element-web, lxc.

Zamba LXC Toolbox

About

Zamba LXC Toolbox is a collection of scripts to easily install Debian LXC containers with preconfigured services on Proxmox with ZFS.
The main feature is Zamba, the fusion of ZFS and Samba in three different flavours (standalone, active directory dc or active directory member), preconfigured to access ZFS snapshots by "Windows Previous Versions" to easily recover encrypted by ransomware files, accidently deleted files or just to revert changes.
The package also provides LXC container installers for mailpiler, matrix-synapse + element-web and more services will follow in future releases.

Requirements

Proxmox VE Server (>=6.30) with at least one configured ZFS Pool.

Included services:

  • bookstack => Bookstack wiki software bookstackapp.com
  • checkmk => Check_MK 2.0 Monitoring Server checkmk.com
  • debian-priv => Debian privileged container with basic toolset
  • debian-unpriv => Debian unprivileged container with basic toolset
  • ecodms => Fullfeatured DMS ecodms.de
  • gitea => Lightweight and fast self-hosted git service gitea.io
  • kimai => Kimai Time-Tracking kimai.org
  • kopano-core => Kopano Core Groupware kopano.io
  • mailpiler => mailpiler mail archive mailpiler.org
  • matrix => Matrix Synapse Homeserver matrix.org with Element Web Element on github
  • nextcloud => Nextcloud Server nextcloud.com with fail2ban und redis configuration
  • omada => TP-Link Omada SDN Controller www.tp-link.com
  • onlyoffice => OnlyOffice onlyoffice.com
  • open3a => Open3a web based accounting software open3a.de
  • proxmox-pbs => Proxmox Backup Server proxmox.com
  • unifi => Unifi Controller ui.com
  • urbackup => UrBackup Server urbackup.org
  • vaultwarden => Bitwarder compatible Passwordmanager github.com/dani-garcia/vaultwarden
  • zabbix => Zabbix Monitoring server zabbix.com
  • zammad => Zammad Helpdesk and Ticketing Software zammad.org
  • zmb-ad => ZMB (Samba) Active Directory Domain Controller, DNS Backends SAMBA_INTERNAL and BIND9_DLZ are supported
  • zmb-ad-join => Additional Active Directory Domain Controller joining an existing Domain
  • zmb-member => ZMB (Samba) AD member with ZFS volume snapshot support
  • zmb-standalone => ZMB (Samba) standalone server with ZFS volume snapshot support

Usage

Just ssh into your Proxmox machine and clone this git repository. Make sure you have installed git.

bash
apt update apt -y install git

Clone this Repository

bash
git clone https://github.com/bashclub/zamba-lxc-toolbox cd zamba-lxc-toolbox

Configuration

Copy zamba.conf.example located in conf directory to a new file (default: zamba.conf) and adjust your desired settings.
For further information about configuration variables, have a look at conf/README.md

bash
cp conf/zamba.conf.example conf/zamba.conf

Installation

After configuring, you are able to launch the script interactively (only works with conf/zamba.conf):

bash
bash install.sh

Advanced Usage

You can set optional parameters (config file, service, container id):

Example:

bash
bash install.sh -i 280 -c conf/my-zmb-service.conf -s zmb-member

You can also view possible parameters with install.sh -h

After container creation, you will be prompted to select the service to install and depending on the service there may be some more questions during installation.

Once the script has finished, the container is installed and running and you can continue with the service specific configuration.

Authors

Markus Helmke

<img src="https://storage.ko-fi.com/cdn/brandasset/kofi_s_tag_dark.png" rel="Support me on Ko-Fi">

Thorsten Spille

<img src="https://storage.ko-fi.com/cdn/brandasset/kofi_s_tag_dark.png" rel="Support me on Ko-Fi">

Contributors

Showing top 9 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from bashclub/zamba-lxc-toolbox via the GitHub API.Last fetched: 6/14/2026