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 recov
Go to file
Thorsten Spille 3a1ee6a2bf
Merge pull request #36 from diddip21/devel
hostname prefix | summary to pct description
2021-08-13 15:14:25 +02:00
archive moved zamba.conf to archive 2021-04-27 09:21:10 +02:00
conf set LXC_HOSTNAME to service name 2021-08-07 18:24:56 +02:00
src Merge branch 'devel' of https://github.com/diddip21/zamba-lxc-toolbox into devel 2021-08-06 22:01:22 +02:00
.gitignore Moved zamba.conf.example to conf folder 2021-04-27 11:17:02 +02:00
CHANGELOG.md Updated Changelog 2021-04-27 09:22:49 +02:00
install.sh set LXC_HOSTNAME to service name 2021-08-07 18:24:56 +02:00
LICENSE Create LICENSE 2021-04-15 23:13:43 +02:00
new-config.py Complete rework UNTESTED UNFINISHED 2021-04-24 00:00:27 +02:00
proxmox.conf Complete rework UNTESTED UNFINISHED 2021-04-24 00:00:27 +02:00
README.md Update README.md 2021-07-29 15:15:45 +02:00
sources.list Push custom apt sources.list to container 2021-04-14 01:01:05 +02:00

Zamba LXC Toolbox

IMPORTANT NOTE:

devel branch is still under heavy development, do not use this on a productive machine!

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 with at least one configured ZFS Pool.

Included services:

  • zmb-standalone => ZMB (Samba) standalone server with ZFS volume snapshot support (previous versions)
  • zmb-ad => ZMB (Samba) Active Directory Domain Controller, DNS Backends SAMBA_INTERNAL and BIND9_DLZ are supported
  • zmb-member => ZMB (Samba) AD member with ZFS volume snapshot support (previous versions)
  • 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
  • checkmk => CheckMK 2.0 Raw Edition checkmk.com with our Fork of Matrix Notification Plugin (https://github.com/bashclub/check_mk_matrix_notifications)
  • open3a => Open3A accounting software for small and medium business open3a.de
  • debian-unpriv => Debian unprivileged container with basic toolset
  • debian-priv => Debian privileged container with basic toolset

Usage

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

apt update
apt -y install git

Clone this Repository

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

Configuration

To fit your requirements, please edit the file zamba.conf with your favourite text editor (e.g. vim or nano). The required adjustments are in the LXC container section and in the section for the service you want to launch. For further information about the config variables, have a look at zamba.conf.md

Installation

After configuring, you are able to launch the script interactively:

bash install.sh

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.