v3.1.0

Important

The karo-stack has moved. This repository and others now live under a new karolabs GitHub organisation.

This is a minor release of the karo-stack. Most of the changes are improvements to the repository itself, and merging the docs into this repo. Highlights for users include the following:

• Private karo-custom stacks can now be defined inside karo-inventory repos, read the docs.

• Docker login credentials can now be set (recommended), read the docs for account setup and vault variables.

What's Changed

• Formatting improvements in #86
• Readme file overhaul in #87
• Justfile internal enhancements in #88
• Setup Prek for pre-commit hooks in #89
• Implement REUSE spec compliance in #90
• Handle inventory symlinks in #91
• GitHub Actions workflow for Prek in #92
• WireGuard nftables improvements in #93
• Add Docker hardened images registry login task in #94
• Merge with karo-docs repo in #95
• Repo migration in #96
• Re-enable Micro editor statusline in #97

Full Changelog: v3.0.0...v3.1.0

v3.0.0

Warning

This release includes breaking changes, please see the documentation for necessary migration steps.

This is a major release of the karo-stack. The highlight for this release is custom stacks.

Users can now create their own Docker compose stacks. Which if made public, other users can then easily add to their own Docker setups. Any stacks which were originally part of this repository, have now been moved to an official karo-custom repo.

What's Changed

• Minor stack tweaks in #70
• Remove git-cliff changelogs in #76
• Add GitHub templates in #77
• Allow for custom stacks in #75
• Docker secrets as templates in #80
• Compose task names and variables in #81
• Custom stacks fixes in #82
• Docker secrets in stack_vars in #83
• karo-custom tweaks in #84

Full Changelog: v2.0.0...v3.0.0

v2.0.0

This is the second major release of the karo-stack. Iterating upon the foundations set in the first release. Implementing essential changes across core parts of the project. And aiming to provide a meaningfully better user experience.

In addition, a huge amount of the work put in over the last four months has been in creating a fully comprehensive documentation site. This is now available at docs.karolabs.dev.

Note

From this point onwards, each new release will be upgradable from the last. And in future, where there are breaking changes, documentation will be provided for any necessary migration steps.

What's Changed

• Post-release improvements in #58
• Docker group directories in #59
• Create proxy stack in #60
• Normalise domains in #62
• Add forward auth toggle options in #61
• Justfile refactor in #63
• Stack updates in #64
• Propagate source IP in Docker in #65
• Configure system hostname in #66
• Compose role rework in #67
• Pre-release enhancements in #68

Full Changelog: v1.0.0...v2.0.0

v1.0.0

This is the first major feature release of the karo-stack. The culmination of five years iterating on self‑hosted deployments and the last four months of dedicated work to build this project.

The karo-stack uses purposely selected technologies - Ansible, Debian, Git and Docker - so users can reliably and efficiently deploy personalised, self‑hosted stacks with idempotent behaviour.

With the core foundations now complete, the next primary goals are project documentation, a Docker image update workflow, and providing additional stacks - all while maintaining and, where possible, improving stability and security.

What's Changed

• Debian Preseed and core Ansible playbook in #1
• Add Traefik reverse proxy stack in #2
• Move Ansible directory files in #3
• Add Ansible vault password file handling in #4
• Improve preseed workflow in #5
• Add Ansible vault file management in #6
• Set default directory for karo user in #7
• Create karo-git Ansible role in #8
• Add Parted and Rsync packages in #25
• Add GoDNS dynamic DNS client stack in #27
• Add Gluetun VPN client stack in #28
• Add qBittorrent downloads manager stack in #29
• Allow custom nftables ports in #31
• Traefik updates in #32
• Improve justfile compose recipes in #33
• Add Pocket-ID OIDC authentication stack in #34
• Add media server stacks in #35
• Add ntfy push notifications stack in #39
• Add Tinyauth forward authentication stack in #40
• Improve compose defaults in #41
• Improve compose logging in #42
• Add Glance dashboard stack in #43
• Split up Servarr stack in #44
• Implement review improvements in #52

Full Changelog: https://github.com/hazzuk/karo-stack/commits/v1.0.0