APT-OSTREE.CONF(5)

NAME
apt-ostree.conf - Configuration file for apt-ostree

SYNOPSIS
/etc/apt-ostree/config.toml

DESCRIPTION
The apt-ostree.conf file contains configuration settings for apt-ostree. The file is written in TOML format and controls various aspects of the system's behavior.

If no configuration file is specified, apt-ostree will use default values.

CONFIGURATION SECTIONS

  [system]
System-wide configuration settings.

data_dir = PATH
    Path to the data directory (default: /var/lib/apt-ostree).

log_level = LEVEL
    Logging level: debug, info, warn, error (default: info).

daemon_socket = PATH
    Path to the daemon socket (default: /run/apt-ostreed.sock).

max_deployments = NUMBER
    Maximum number of deployments to keep (default: 3).

  [ostree]
OSTree-specific configuration.

repo_path = PATH
    Path to the OSTree repository (default: /ostree/repo).

deploy_path = PATH
    Path to deployments (default: /ostree/deploy).

booted_deployment = NAME
    Name of the currently booted deployment.

default_branch = BRANCH
    Default branch for deployments (default: debian/13/amd64).

  [apt]
APT package management configuration.

sources_list = PATH
    Path to APT sources list (default: /etc/apt/sources.list).

apt_conf = PATH
    Path to APT configuration (default: /etc/apt/apt.conf).

cache_dir = PATH
    APT cache directory (default: /var/cache/apt).

state_dir = PATH
    APT state directory (default: /var/lib/apt).

  [security]
Security and authentication settings.

polkit_enabled = BOOL
    Enable Polkit authentication (default: true).

require_auth = BOOL
    Require authentication for privileged operations (default: true).

allowed_users = USERS
    List of users allowed to perform operations.

allowed_groups = GROUPS
    List of groups allowed to perform operations.

  [daemon]
Daemon service configuration.

user = USER
    User to run the daemon as (default: root).

group = GROUP
    Group to run the daemon as (default: root).

pid_file = PATH
    Path to PID file (default: /run/apt-ostreed.pid).

log_file = PATH
    Path to log file (default: /var/log/apt-ostreed.log).

  [development]
Development and debugging features.

enable_dev_commands = BOOL
    Enable development commands (default: false).

debug_mode = BOOL
    Enable debug mode (default: false).

test_mode = BOOL
    Enable test mode (default: false).

EXAMPLE CONFIGURATION
# System configuration
[system]
data_dir = "/var/lib/apt-ostree"
log_level = "info"
max_deployments = 5
# OSTree configuration
[ostree]
repo_path = "/ostree/repo"
deploy_path = "/ostree/deploy"
default_branch = "debian/13/amd64"
# APT configuration
[apt]
sources_list = "/etc/apt/sources.list"
cache_dir = "/var/cache/apt"
# Security configuration
[security]
polkit_enabled = true
require_auth = true
allowed_users = ["admin", "root"]
# Daemon configuration
[daemon]
user = "root"
group = "root"
log_file = "/var/log/apt-ostreed.log"
# Development features
[development]
enable_dev_commands = false
debug_mode = false

FILES

/etc/apt-ostree/config.toml
    Default configuration file location.

/etc/apt-ostree/
    Configuration directory.

~/.config/apt-ostree/config.toml
    User-specific configuration file.

ENVIRONMENT

APT_OSTREE_CONFIG
    Override the default configuration file path.

NOTES
The configuration file is read when apt-ostree starts. Changes to the configuration file require restarting the daemon to take effect.

Boolean values can be specified as true/false, yes/no, or 1/0.

Paths can be absolute or relative to the configuration file location.

BUGS
Report bugs to the project issue tracker at https://github.com/robojerk/apt-ostree/issues.

AUTHOR
Written by Robojerk <robojerk@example.com>.

COPYRIGHT
Copyright © 2025 Robojerk. License GPL-3.0-or-later: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO
apt-ostree(1), apt-ostree-dev(1), ostree(1), apt(8)