Common¶

Overview¶

Sets up common directories, installs essential packages, handles BTRFS optimizations, and configures basic system tools.

Saltbox dependency.

sb install common

Info

Variables can be overridden in /srv/git/saltbox/inventories/host_vars/localhost.yml.

Example Override

nano_syntax_highlighting_enabled: true

GeneralGlobal Override Options

nano_syntax_highlighting_enabled

# Type: bool (true/false)
nano_syntax_highlighting_enabled: true

common_create_media_subfolders

# Type: bool (true/false)
common_create_media_subfolders: true

common_role_autoheal_enabled

# Enable or disable Autoheal monitoring for the container created when deploying
# Type: bool (true/false)
common_role_autoheal_enabled: true

common_role_depends_on

# List of container dependencies that must be running before the container start
# Type: string
common_role_depends_on: ""

common_role_depends_on_delay

# Delay in seconds before starting the container after dependencies are ready
# Type: string (quoted number)
common_role_depends_on_delay: "0"

common_role_depends_on_healthchecks

# Enable healthcheck waiting for container dependencies
# Type: string ("true"/"false")
common_role_depends_on_healthchecks:

common_role_diun_enabled

# Enable or disable Diun update notifications for the container created when deploying
# Type: bool (true/false)
common_role_diun_enabled: true

common_role_dns_enabled

# Enable or disable automatic DNS record creation for the container
# Type: bool (true/false)
common_role_dns_enabled: true

common_role_docker_controller

# Enable or disable Saltbox Docker Controller management for the container
# Type: bool (true/false)
common_role_docker_controller: true

common_role_traefik_autodetect_enabled

# Enable Traefik autodetect middleware for the container
# Type: bool (true/false)
common_role_traefik_autodetect_enabled: false

common_role_traefik_crowdsec_enabled

# Enable CrowdSec middleware for the container
# Type: bool (true/false)
common_role_traefik_crowdsec_enabled: false

common_role_traefik_error_pages_enabled

# Enable custom error pages middleware for the container
# Type: bool (true/false)
common_role_traefik_error_pages_enabled: false

common_role_traefik_gzip_enabled

# Enable gzip compression middleware for the container
# Type: bool (true/false)
common_role_traefik_gzip_enabled: false

common_role_traefik_middleware_http_api_insecure

# Type: bool (true/false)
common_role_traefik_middleware_http_api_insecure:

common_role_traefik_middleware_http_insecure

# Type: bool (true/false)
common_role_traefik_middleware_http_insecure:

common_role_traefik_robot_enabled

# Enable robots.txt middleware for the container
# Type: bool (true/false)
common_role_traefik_robot_enabled: true

common_role_traefik_tailscale_enabled

# Enable Tailscale-specific Traefik configuration for the container
# Type: bool (true/false)
common_role_traefik_tailscale_enabled: false

common_role_traefik_wildcard_enabled

# Enable wildcard certificate for the container
# Type: bool (true/false)
common_role_traefik_wildcard_enabled: true

common_role_web_fqdn_override

# Override the Traefik fully qualified domain name (FQDN) for the container
# Type: list
common_role_web_fqdn_override:

Example Override

common_role_web_fqdn_override:
  - "{{ traefik_host }}"
  - "common2.{{ user.domain }}"
  - "common.otherdomain.tld"

Note: Include {{ traefik_host }} to preserve the default FQDN alongside your custom entries

common_role_web_host_override

# Override the Traefik web host configuration for the container
# Type: string
common_role_web_host_override:

Example Override

common_role_web_host_override: "Host(`{{ traefik_host }}`) || Host(`{{ 'common2.' + user.domain }}`)"

Note: Use {{ traefik_host }} to include the default host configuration in your custom rule

common_role_web_scheme

# URL scheme to use for web access to the container
# Type: string ("http"/"https")
common_role_web_scheme: