Skip to content

Custom

Overview

Custom is a Saltbox module that allows you to install additional software packages (APT, DEB, and pip modules) that are not included in the default Saltbox installation, giving you the flexibility to add tools and dependencies specific to your needs.


Configuration

Before running the custom tag, configure the packages you want to install in your Saltbox inventory:

APT packages:

custom_apt:
  - package_name_1
  - package_name_2

DEB packages (direct URLs):

custom_deb:
  - https://example.com/package.deb

pip modules (Ubuntu 22.04 and earlier only):

custom_pip:
  - module_name

Deployment

sb install custom

Info

The custom role is useful for installing system utilities, development tools, or dependencies required by other applications in your setup.

Warning

pip installation via this role is only available on Ubuntu 22.04 and earlier.

Role Defaults

Use the Inventory to customize variables. (1)

  1. Example override

    custom_apt: ["item1", "item2"]
    
custom_apt
# Type: list
custom_apt: []
custom_deb
# Type: list
custom_deb: []
custom_pip
# Type: list
custom_pip: []