Config Commands

The config group lets you inspect and manage the active acs2md configuration without editing YAML by hand.

These commands are useful for repeatable workstation setup, CI preparation, and support scenarios where you need a clear audit trail of configuration changes.

config create

Creates a new config file at the default location, pre-filled with all available settings and their default values.


acs2md config create

If a config file already exists, the command will not overwrite it. Delete the existing file first if you want to reset to defaults.

config where

Prints the full path to the active config file.


acs2md config where

Example output:


/Users/alice/Library/Application Support/acs2md/config.yaml

config list

Displays all current configuration values, including those loaded from environment variables and CLI flags.


acs2md config list

Use this when you need to inspect the effective configuration instead of only the values written to disk.

config get

Retrieves the value of a single configuration key.


acs2md config get KEY

Examples


acs2md config get confluence.domain
acs2md config get log.level
acs2md config get http.client.max_retries

config set

Sets a configuration value and saves it to the config file.


acs2md config set KEY VALUE

Examples


# Confluence credentials
acs2md config set confluence.domain mycompany.atlassian.net
acs2md config set confluence.username you@example.com
acs2md config set confluence.api_token YOUR_API_TOKEN
 
# Logging
acs2md config set log.level debug
acs2md config set log.format json
acs2md config set log.file /var/log/acs2md.log
 
# HTTP
acs2md config set http.client.max_retries 5
acs2md config set http.client.proxy "http://proxy.corp.example.com:8080"
 
# Images
acs2md config set image.cache_dir /tmp/acs2md-cache
acs2md config set image.max_size_bytes 20971520

Available config keys

Key	Description
`confluence.domain`	Confluence instance domain
`confluence.username`	Atlassian account email
`confluence.api_token`	Confluence API token
`http.client.max_retries`	Number of HTTP retry attempts
`http.client.base_timeout`	Base request timeout (e.g. `10ms`)
`http.client.max_timeout`	Max request timeout (e.g. `100ms`)
`http.client.proxy`	HTTP proxy URL
`log.level`	Log level: `debug`, `info`, `warn`, `error`
`log.format`	Log format: `text`, `json`
`log.file`	Log output: `stdout`, `stderr`, or a file path
`debug.enabled`	Enable debug mode (`true` / `false`)
`image.cache_dir`	Directory for caching downloaded images
`image.max_size_bytes`	Maximum image size in bytes

Recommended workflow

run acs2md config create
set the Confluence connection values with config set
confirm them with config get or config list
run acs2md doctor