Skip to content

rledger config

Manage rustledger configuration files and settings.

Usage

bash
rledger config <COMMAND>

Commands

CommandDescription
showShow the merged configuration from all sources
pathShow config file search paths
editOpen config file in editor
initGenerate a default config file
aliasesList configured aliases

Options

OptionDescription
-P, --profile <PROFILE>Use a specific profile from config

Examples

Show Current Config

bash
rledger config show

Output:

toml
[default]
file = "/home/user/finances/main.beancount"

[check]
auto = true

[query]
format = "text"

Show Config Paths

bash
rledger config path

Output:

Searching for config in:
  1. ./rledger.toml
  2. ./.rledger.toml
  3. /home/user/.config/rledger/config.toml
  4. /home/user/.rledger.toml

Found: /home/user/.config/rledger/config.toml

Create Default Config

bash
rledger config init

Creates ~/.config/rledger/config.toml with default settings.

Edit Config

bash
rledger config edit

Opens config file in $EDITOR (or vi if not set).

List Aliases

bash
rledger config aliases

Output:

Configured aliases:
  bal     -> query "BALANCES"
  recent  -> query "SELECT date, payee, narration ORDER BY date DESC LIMIT 20"

Config File Format

See Configuration for the full config file reference.

See Also