Ei kuvausta

xcad 5765491012 chore: merge release/v0.0.7 into main 3 kuukautta sitten
.github 0398935b5c feat: add template schema versioning and variable-level dependencies (#1360) 4 kuukautta sitten
cli 27df602f72 new release + pihole template 3 kuukautta sitten
library f9fdc26e1c chore: merge release/v0.0.7 into main 3 kuukautta sitten
scripts aa08a94356 fix: improve template version sync to process only changed files 4 kuukautta sitten
tests 7b98d03e20 hotfix/v0.0.5 4 kuukautta sitten
.editorconfig 9990395193 chore(config): align code formatting with PEP 8 standards 3 kuukautta sitten
.gitignore f9fdc26e1c chore: merge release/v0.0.7 into main 3 kuukautta sitten
.yamllint 94f642aa04 fix: resolve yamllint issues 4 kuukautta sitten
AGENTS.md 27df602f72 new release + pihole template 3 kuukautta sitten
CHANGELOG.md f9fdc26e1c chore: merge release/v0.0.7 into main 3 kuukautta sitten
LICENSE 7e7cbc3d4a Initial commit 4 vuotta sitten
MANIFEST.in 8921b8cb13 fix: configure package discovery and include library directory 4 kuukautta sitten
README.md 0b770f150b new readme 4 kuukautta sitten
SECURITY.md 52a4363e45 fixed typo 2 vuotta sitten
WARP.md 34f49752b2 added link 4 kuukautta sitten
pyproject.toml 9990395193 chore(config): align code formatting with PEP 8 standards 3 kuukautta sitten
renovate.json e5466d997c fix(renovate): configure bot identity to prevent edit warnings 3 kuukautta sitten
requirements.txt a95097699a chore(deps): update dependency rich to v14.2.0 (#1336) 4 kuukautta sitten

README.md

Christian's Boilerplates

Welcome

Hey, there!

I'm Christian, and I'm passionate about creating educational tech content for IT Pros and Homelab nerds.

What are Boilerplates?

Boilerplates is a curated collection of production-ready templates for your homelab and infrastructure projects. Stop copying configurations from random GitHub repos or starting from scratch every time you spin up a new service!

Boilerplates CLI

The Boilerplates CLI tool gives you instant access to battle-tested templates for Docker, Terraform, Ansible, Kubernetes, and more.

Each template includes sensible defaults, best practices, and common configuration patterns—so you can focus on customizing for your environment.

Key Features:

  • 🚀 Quick Setup - Generate complete project structures in seconds
  • 🔧 Fully Customizable - Interactive prompts or non-interactive mode with variable overrides
  • 💾 Smart Defaults - Save your preferred values and reuse across projects

Note: Technologies evolve rapidly. While I actively maintain these templates, always review generated configurations before deploying to production.

Installation

Install the Boilerplates CLI using the automated installer:

# Install latest version
curl -fsSL https://raw.githubusercontent.com/christianlempa/boilerplates/main/scripts/install.sh | bash

# Install specific version
curl -fsSL https://raw.githubusercontent.com/christianlempa/boilerplates/main/scripts/install.sh | bash -s -- --version v1.2.3

The installer uses pipx to create an isolated environment for the CLI tool. Once installed, the boilerplates command will be available in your terminal.

Quick Start

# Explore 
boilerplates --help

# Update Repository Library
boilerplates repo update

# List all available templates for a docker compose
boilerplates compose list

# Show details about a specific template
boilerplates compose show nginx

# Generate a template (interactive mode)
boilerplates compose generate authentik

# Generate with custom output directory
boilerplates compose generate nginx my-nginx-server

# Non-interactive mode with variable overrides
boilerplates compose generate traefik my-proxy \
  --var service_name=traefik \
  --var traefik_enabled=true \
  --var traefik_host=proxy.example.com \
  --no-interactive

Managing Defaults

Save time by setting default values for variables you use frequently:

# Set a default value
boilerplates compose defaults set container_timezone "America/New_York"
boilerplates compose defaults set restart_policy "unless-stopped"

Template Libraries

Boilerplates uses git-based libraries to manage templates. You can add custom repositories:

# List configured libraries
boilerplates repo list

# Update all libraries
boilerplates repo update

# Add a custom library
boilerplates repo add my-templates https://github.com/user/templates \
  --directory library \
  --branch main

# Remove a library
boilerplates repo remove my-templates

Documentation

For comprehensive documentation, advanced usage, and template development guides, check out the Wiki (coming soon).

If you're looking for detailed tutorials on specific tools and technologies, visit my YouTube Channel.

Contribution

If you’d like to contribute to this project, reach out to me on social media or Discord, or create a pull request for the necessary changes.

Other Resources

  • Dotfiles - My personal configuration files on macOS
  • Cheat-Sheets - Command Reference for various tools and technologies

Support me

Creating high-quality videos and valuable resources that are accessible to everyone, free of charge, is a huge challenge. With your contribution, I can dedicate more time and effort into the creation process, which ultimately enhances the quality of the content. So, all your support, by becoming a member, truly makes a significant impact on what I do. And you’ll also get some cool benefits and perks in return, as a recognition of your support.

Remember, supporting me is entirely optional. Your choice to become a member or not won't change your access to my videos and resources. You are also welcome to reach out to me on Discord, if you have any questions or feedback.

https://www.patreon.com/christianlempa