config
Type
External
Status
Published
Created
Jul 18, 2026
Updated
Jul 18, 2026

config#

The config command helps you manage opnDossier's own settings -- not your OPNsense configuration. Use it to generate a starter config file, inspect what settings are currently active (and where they come from), or validate that a config file is correct.

When to use it:

  • Setting up opnDossier for the first time with config init
  • Debugging unexpected behavior by checking which settings are active and their source with config show
  • Validating a config file before deploying it to a shared environment or CI pipeline

Usage#

opndossier config <subcommand> [flags]

Subcommands#

show#

Display the current effective configuration with source indicators.

FlagShortDefaultDescription
--jsonfalseOutput configuration in JSON format

init#

Generate a template configuration file.

FlagShortDefaultDescription
--output~/.opnDossier.yamlOutput path for the generated template

validate#

Validate an existing configuration file for correctness.

opndossier config validate <path>

Examples#

# Show current configuration
opndossier config show

# Show configuration as JSON
opndossier config show --json

# Generate template at a specific path
opndossier config init --output ~/.opnDossier.yaml

# Validate a configuration file
opndossier config validate ~/.opnDossier.yaml