Skip to content

Autobrr¶

Description / nameInput element
Your domain name

Overview¶

Autobrr is a modern download automation tool designed for torrents and Usenet, serving as a comprehensive replacement for older tools like autodl-irssi, trackarr, and flexget.


Deployment¶

sb install autobrr

Usage¶

Visit https://autobrr.iYOUR_DOMAIN_NAMEi.

Basics¶

Role Defaults¶

Variables can be customized using the Inventory. (1)

  1. Example override

    autobrr_name: "custom_value"
    

    Avoid overriding variables ending in _default

    When overriding variables that end in _default (like autobrr_docker_envs_default), you replace the entire default configuration. Future updates that add new default values will not be applied to your setup, potentially breaking functionality.

    Instead, use the corresponding _custom variable (like autobrr_docker_envs_custom) to add your changes. Custom values are merged with defaults, ensuring you receive updates.

autobrr_name
# Type: string
autobrr_name: autobrr
autobrr_role_web_subdomain
# Type: string
autobrr_role_web_subdomain: "{{ autobrr_name }}"
autobrr_role_web_domain
# Type: string
autobrr_role_web_domain: "{{ user.domain }}"
autobrr_role_web_port
# Type: string
autobrr_role_web_port: "7474"
autobrr_role_web_url
# Type: string
autobrr_role_web_url: "{{ 'https://' + (lookup('role_var', '_web_subdomain', role='autobrr') + '.' + lookup('role_var', '_web_domain', role='autobrr')
                       if (lookup('role_var', '_web_subdomain', role='autobrr') | length > 0)
                       else lookup('role_var', '_web_domain', role='autobrr')) }}"
autobrr_role_dns_record
# Type: string
autobrr_role_dns_record: "{{ lookup('role_var', '_web_subdomain', role='autobrr') }}"
autobrr_role_dns_zone
# Type: string
autobrr_role_dns_zone: "{{ lookup('role_var', '_web_domain', role='autobrr') }}"
autobrr_role_dns_proxy
# Type: bool (true/false)
autobrr_role_dns_proxy: "{{ dns_proxied }}"
autobrr_role_traefik_sso_middleware
# Type: string
autobrr_role_traefik_sso_middleware: "{{ traefik_default_sso_middleware }}"
autobrr_role_traefik_middleware_default
# Type: string
autobrr_role_traefik_middleware_default: "{{ traefik_default_middleware }}"
autobrr_role_traefik_middleware_custom
# Type: string
autobrr_role_traefik_middleware_custom: ""
autobrr_role_traefik_certresolver
# Type: string
autobrr_role_traefik_certresolver: "{{ traefik_default_certresolver }}"
autobrr_role_traefik_enabled
# Type: bool (true/false)
autobrr_role_traefik_enabled: true
autobrr_role_traefik_api_enabled
# Type: bool (true/false)
autobrr_role_traefik_api_enabled: true
autobrr_role_traefik_api_endpoint
# Type: string
autobrr_role_traefik_api_endpoint: "PathPrefix(`/api`)"

Container

autobrr_role_docker_container
# Type: string
autobrr_role_docker_container: "{{ autobrr_name }}"

Image

autobrr_role_docker_image_pull
# Type: bool (true/false)
autobrr_role_docker_image_pull: true
autobrr_role_docker_image_repo
# Type: string
autobrr_role_docker_image_repo: "ghcr.io/autobrr/autobrr"
autobrr_role_docker_image_tag
# Type: string
autobrr_role_docker_image_tag: "latest"
autobrr_role_docker_image
# Type: string
autobrr_role_docker_image: "{{ lookup('role_var', '_docker_image_repo', role='autobrr') }}:{{ lookup('role_var', '_docker_image_tag', role='autobrr') }}"

Envs

autobrr_role_docker_envs_default
# Type: dict
autobrr_role_docker_envs_default:
  AUTOBRR__LOG_PATH: "/config/logs"
  PUID: "{{ uid }}"
  PGID: "{{ gid }}"
  TZ: "{{ tz }}"
autobrr_role_docker_envs_custom
# Type: dict
autobrr_role_docker_envs_custom: {}

Volumes

autobrr_role_docker_volumes_default
# Type: list
autobrr_role_docker_volumes_default:
  - "{{ autobrr_role_paths_location }}:/config"
autobrr_role_docker_volumes_custom
# Type: list
autobrr_role_docker_volumes_custom: []

Hostname

autobrr_role_docker_hostname
# Type: string
autobrr_role_docker_hostname: "{{ autobrr_name }}"

Networks

autobrr_role_docker_networks_alias
# Type: string
autobrr_role_docker_networks_alias: "{{ autobrr_name }}"
autobrr_role_docker_networks_default
# Type: list
autobrr_role_docker_networks_default: []
autobrr_role_docker_networks_custom
# Type: list
autobrr_role_docker_networks_custom: []

Restart Policy

autobrr_role_docker_restart_policy
# Type: string
autobrr_role_docker_restart_policy: unless-stopped

State

autobrr_role_docker_state
# Type: string
autobrr_role_docker_state: started

The following advanced options are available via create_docker_container but are not defined in the role. See: docker_container module

Resource Limits

autobrr_role_docker_blkio_weight
# Type: int
autobrr_role_docker_blkio_weight:
autobrr_role_docker_cpu_period
# Type: int
autobrr_role_docker_cpu_period:
autobrr_role_docker_cpu_quota
# Type: int
autobrr_role_docker_cpu_quota:
autobrr_role_docker_cpu_shares
# Type: int
autobrr_role_docker_cpu_shares:
autobrr_role_docker_cpus
# Type: string
autobrr_role_docker_cpus:
autobrr_role_docker_cpuset_cpus
# Type: string
autobrr_role_docker_cpuset_cpus:
autobrr_role_docker_cpuset_mems
# Type: string
autobrr_role_docker_cpuset_mems:
autobrr_role_docker_kernel_memory
# Type: string
autobrr_role_docker_kernel_memory:
autobrr_role_docker_memory
# Type: string
autobrr_role_docker_memory:
autobrr_role_docker_memory_reservation
# Type: string
autobrr_role_docker_memory_reservation:
autobrr_role_docker_memory_swap
# Type: string
autobrr_role_docker_memory_swap:
autobrr_role_docker_memory_swappiness
# Type: int
autobrr_role_docker_memory_swappiness:
autobrr_role_docker_shm_size
# Type: string
autobrr_role_docker_shm_size:

Security & Devices

autobrr_role_docker_cap_drop
# Type: list
autobrr_role_docker_cap_drop:
autobrr_role_docker_cgroupns_mode
# Type: string
autobrr_role_docker_cgroupns_mode:
autobrr_role_docker_device_cgroup_rules
# Type: list
autobrr_role_docker_device_cgroup_rules:
autobrr_role_docker_device_read_bps
# Type: list
autobrr_role_docker_device_read_bps:
autobrr_role_docker_device_read_iops
# Type: list
autobrr_role_docker_device_read_iops:
autobrr_role_docker_device_requests
# Type: list
autobrr_role_docker_device_requests:
autobrr_role_docker_device_write_bps
# Type: list
autobrr_role_docker_device_write_bps:
autobrr_role_docker_device_write_iops
# Type: list
autobrr_role_docker_device_write_iops:
autobrr_role_docker_devices
# Type: list
autobrr_role_docker_devices:
autobrr_role_docker_devices_default
# Type: string
autobrr_role_docker_devices_default:
autobrr_role_docker_groups
# Type: list
autobrr_role_docker_groups:
autobrr_role_docker_privileged
# Type: bool (true/false)
autobrr_role_docker_privileged:
autobrr_role_docker_security_opts
# Type: list
autobrr_role_docker_security_opts:
autobrr_role_docker_user
# Type: string
autobrr_role_docker_user:
autobrr_role_docker_userns_mode
# Type: string
autobrr_role_docker_userns_mode:

Networking

autobrr_role_docker_dns_opts
# Type: list
autobrr_role_docker_dns_opts:
autobrr_role_docker_dns_search_domains
# Type: list
autobrr_role_docker_dns_search_domains:
autobrr_role_docker_dns_servers
# Type: list
autobrr_role_docker_dns_servers:
autobrr_role_docker_domainname
# Type: string
autobrr_role_docker_domainname:
autobrr_role_docker_exposed_ports
# Type: list
autobrr_role_docker_exposed_ports:
autobrr_role_docker_hosts
# Type: dict
autobrr_role_docker_hosts:
autobrr_role_docker_hosts_use_common
# Type: bool (true/false)
autobrr_role_docker_hosts_use_common:
autobrr_role_docker_ipc_mode
# Type: string
autobrr_role_docker_ipc_mode:
autobrr_role_docker_links
# Type: list
autobrr_role_docker_links:
autobrr_role_docker_network_mode
# Type: string
autobrr_role_docker_network_mode:
autobrr_role_docker_pid_mode
# Type: string
autobrr_role_docker_pid_mode:
autobrr_role_docker_ports
# Type: list
autobrr_role_docker_ports:
autobrr_role_docker_uts
# Type: string
autobrr_role_docker_uts:

Storage

autobrr_role_docker_keep_volumes
# Type: bool (true/false)
autobrr_role_docker_keep_volumes:
autobrr_role_docker_mounts
# Type: list
autobrr_role_docker_mounts:
autobrr_role_docker_storage_opts
# Type: dict
autobrr_role_docker_storage_opts:
autobrr_role_docker_tmpfs
# Type: list
autobrr_role_docker_tmpfs:
autobrr_role_docker_volume_driver
# Type: string
autobrr_role_docker_volume_driver:
autobrr_role_docker_volumes_from
# Type: list
autobrr_role_docker_volumes_from:
autobrr_role_docker_volumes_global
# Type: bool (true/false)
autobrr_role_docker_volumes_global:
autobrr_role_docker_working_dir
# Type: string
autobrr_role_docker_working_dir:

Monitoring & Lifecycle

autobrr_role_docker_auto_remove
# Type: bool (true/false)
autobrr_role_docker_auto_remove:
autobrr_role_docker_cleanup
# Type: bool (true/false)
autobrr_role_docker_cleanup:
autobrr_role_docker_force_kill
# Type: string
autobrr_role_docker_force_kill:
autobrr_role_docker_healthcheck
# Type: dict
autobrr_role_docker_healthcheck:
autobrr_role_docker_healthy_wait_timeout
# Type: int
autobrr_role_docker_healthy_wait_timeout:
autobrr_role_docker_init
# Type: bool (true/false)
autobrr_role_docker_init:
autobrr_role_docker_kill_signal
# Type: string
autobrr_role_docker_kill_signal:
autobrr_role_docker_log_driver
# Type: string
autobrr_role_docker_log_driver:
autobrr_role_docker_log_options
# Type: dict
autobrr_role_docker_log_options:
autobrr_role_docker_oom_killer
# Type: bool (true/false)
autobrr_role_docker_oom_killer:
autobrr_role_docker_oom_score_adj
# Type: int
autobrr_role_docker_oom_score_adj:
autobrr_role_docker_output_logs
# Type: bool (true/false)
autobrr_role_docker_output_logs:
autobrr_role_docker_paused
# Type: bool (true/false)
autobrr_role_docker_paused:
autobrr_role_docker_recreate
# Type: bool (true/false)
autobrr_role_docker_recreate:
autobrr_role_docker_restart_retries
# Type: int
autobrr_role_docker_restart_retries:
autobrr_role_docker_stop_timeout
# Type: int
autobrr_role_docker_stop_timeout:

Other Options

autobrr_role_docker_capabilities
# Type: list
autobrr_role_docker_capabilities:
autobrr_role_docker_cgroup_parent
# Type: string
autobrr_role_docker_cgroup_parent:
autobrr_role_docker_commands
# Type: list
autobrr_role_docker_commands:
autobrr_role_docker_create_timeout
# Type: int
autobrr_role_docker_create_timeout:
autobrr_role_docker_entrypoint
# Type: string
autobrr_role_docker_entrypoint:
autobrr_role_docker_env_file
# Type: string
autobrr_role_docker_env_file:
autobrr_role_docker_labels
# Type: dict
autobrr_role_docker_labels:
autobrr_role_docker_labels_use_common
# Type: bool (true/false)
autobrr_role_docker_labels_use_common:
autobrr_role_docker_read_only
# Type: bool (true/false)
autobrr_role_docker_read_only:
autobrr_role_docker_runtime
# Type: string
autobrr_role_docker_runtime:
autobrr_role_docker_sysctls
# Type: list
autobrr_role_docker_sysctls:
autobrr_role_docker_ulimits
# Type: list
autobrr_role_docker_ulimits:
autobrr_role_autoheal_enabled
# Enable or disable Autoheal monitoring for the container created when deploying
# Type: bool (true/false)
autobrr_role_autoheal_enabled: true
autobrr_role_depends_on
# List of container dependencies that must be running before the container start
# Type: string
autobrr_role_depends_on: ""
autobrr_role_depends_on_delay
# Delay in seconds before starting the container after dependencies are ready
# Type: string (quoted number)
autobrr_role_depends_on_delay: "0"
autobrr_role_depends_on_healthchecks
# Enable healthcheck waiting for container dependencies
# Type: string ("true"/"false")
autobrr_role_depends_on_healthchecks:
autobrr_role_diun_enabled
# Enable or disable Diun update notifications for the container created when deploying
# Type: bool (true/false)
autobrr_role_diun_enabled: true
autobrr_role_dns_enabled
# Enable or disable automatic DNS record creation for the container
# Type: bool (true/false)
autobrr_role_dns_enabled: true
autobrr_role_docker_controller
# Enable or disable Saltbox Docker Controller management for the container
# Type: bool (true/false)
autobrr_role_docker_controller: true
autobrr_role_docker_networks_alias_custom
# Type: list
autobrr_role_docker_networks_alias_custom:
autobrr_role_docker_volumes_download
# Type: bool (true/false)
autobrr_role_docker_volumes_download:
autobrr_role_themepark_addons
# Type: string
autobrr_role_themepark_addons:
autobrr_role_themepark_app
# Type: string
autobrr_role_themepark_app:
autobrr_role_themepark_theme
# Type: string
autobrr_role_themepark_theme:
autobrr_role_traefik_api_middleware
# Type: string
autobrr_role_traefik_api_middleware:
autobrr_role_traefik_api_middleware_http
# Type: string
autobrr_role_traefik_api_middleware_http:
autobrr_role_traefik_autodetect_enabled
# Enable Traefik autodetect middleware for the container
# Type: bool (true/false)
autobrr_role_traefik_autodetect_enabled: false
autobrr_role_traefik_crowdsec_enabled
# Enable CrowdSec middleware for the container
# Type: bool (true/false)
autobrr_role_traefik_crowdsec_enabled: false
autobrr_role_traefik_error_pages_enabled
# Enable custom error pages middleware for the container
# Type: bool (true/false)
autobrr_role_traefik_error_pages_enabled: false
autobrr_role_traefik_gzip_enabled
# Enable gzip compression middleware for the container
# Type: bool (true/false)
autobrr_role_traefik_gzip_enabled: false
autobrr_role_traefik_middleware_http
# Type: string
autobrr_role_traefik_middleware_http:
autobrr_role_traefik_middleware_http_api_insecure
# Type: bool (true/false)
autobrr_role_traefik_middleware_http_api_insecure:
autobrr_role_traefik_middleware_http_insecure
# Type: bool (true/false)
autobrr_role_traefik_middleware_http_insecure:
autobrr_role_traefik_priority
# Type: string
autobrr_role_traefik_priority:
autobrr_role_traefik_robot_enabled
# Enable robots.txt middleware for the container
# Type: bool (true/false)
autobrr_role_traefik_robot_enabled: true
autobrr_role_traefik_tailscale_enabled
# Enable Tailscale-specific Traefik configuration for the container
# Type: bool (true/false)
autobrr_role_traefik_tailscale_enabled: false
autobrr_role_traefik_wildcard_enabled
# Enable wildcard certificate for the container
# Type: bool (true/false)
autobrr_role_traefik_wildcard_enabled: true
autobrr_role_web_api_http_port
# Type: string (quoted number)
autobrr_role_web_api_http_port:
autobrr_role_web_api_http_scheme
# Type: string ("http"/"https")
autobrr_role_web_api_http_scheme:
autobrr_role_web_api_http_serverstransport
# Type: dict/omit
autobrr_role_web_api_http_serverstransport:
autobrr_role_web_api_port
# Type: string (quoted number)
autobrr_role_web_api_port:
autobrr_role_web_api_scheme
# Type: string ("http"/"https")
autobrr_role_web_api_scheme:
autobrr_role_web_api_serverstransport
# Type: dict/omit
autobrr_role_web_api_serverstransport:
autobrr_role_web_fqdn_override
# Override the Traefik fully qualified domain name (FQDN) for the container
# Type: list
autobrr_role_web_fqdn_override:

Example Override

autobrr_role_web_fqdn_override:
  - "{{ traefik_host }}"
  - "autobrr2.{{ user.domain }}"
  - "autobrr.otherdomain.tld"

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

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

Example Override

autobrr_role_web_host_override: "Host(`{{ traefik_host }}`) || Host(`{{ 'autobrr2.' + user.domain }}`)"

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

autobrr_role_web_http_port
# Type: string (quoted number)
autobrr_role_web_http_port:
autobrr_role_web_http_scheme
# Type: string ("http"/"https")
autobrr_role_web_http_scheme:
autobrr_role_web_http_serverstransport
# Type: dict/omit
autobrr_role_web_http_serverstransport:
autobrr_role_web_scheme
# URL scheme to use for web access to the container
# Type: string ("http"/"https")
autobrr_role_web_scheme:
autobrr_role_web_serverstransport
# Type: dict/omit
autobrr_role_web_serverstransport: