Skip to content

Automation

Linutil supports automation via a TOML config file. This lets you run predefined scripts automatically — useful for setting up multiple machines, provisioning servers, or scripting a consistent Linux environment.

Config File

Create a TOML file with your desired settings:

# example_config.toml

auto_execute = [
    "Fastfetch",
    "Alacritty",
    "Kitty"
]

skip_confirmation = true
size_bypass = true

Then run Linutil with your config:

linutil --config /path/to/example_config.toml

Or via the one-liner:

curl -fsSL https://christitus.com/linux | sh -s -- --config /path/to/example_config.toml

Config Options

OptionTypeDescription
auto_executelist of stringsScript names to run automatically on launch
skip_confirmationbooleanSkip confirmation prompts before running scripts
size_bypassbooleanBypass terminal size requirements

CLI Flags

The same options are available as command-line flags:

linutil --skip-confirmation --size-bypass
FlagDescription
--config / -cPath to TOML config file
--skip-confirmationSkip all confirmation prompts
--size-bypassBypass minimum terminal size check

Use Cases

Provision a New Machine

Create a config that installs your standard set of tools:

auto_execute = [
    "Bash Prompt",
    "Fastfetch",
    "VS Code",
    "Docker",
    "ZSH Prompt"
]

skip_confirmation = true

Run it on any new Linux install to get your environment set up in one shot.

Server Setup

auto_execute = [
    "Full System Update",
    "UFW Firewall Baselines (CTT)",
    "Docker"
]

skip_confirmation = true

Finding Script Names

Script names in auto_execute must match exactly as they appear in the Linutil TUI. Browse the TUI to find the exact name, or check the auto-generated Walkthrough page for a complete list.

Tip

Use --skip-confirmation together with auto_execute for fully unattended runs. Without it, Linutil will still pause and ask before executing each script.

Last updated on