User Configuration¶

The config command group allows you to manage global user configuration settings for mcup. These settings persist across sessions.

Known Configuration Keys¶

Key	Description	Default Value
`java.path`	The path to the Java executable to use for running servers.	`java`
`logging.level`	The logging level for the CLI output (e.g., `DEBUG`, `INFO`).	`INFO`
`devtools.enabled`	Enable developer tools commands (`confdiff`, `lockermgr`).	`false`
`advancedmode.enabled`	Enable advanced fields in the server configuration wizard.	`false`
`locker.remote`	The URL of the remote locker file to use for updates.	(Standard URL)
`locker.branch`	The branch of the remote locker repository to use (if applicable).	`main`

Retrieve the value of a specific configuration key.

mcup config get <key>

Argument	Description
`key`	The configuration key to retrieve.

Get the current Java path:

mcup config get java.path

Set the value for a specific configuration key.

mcup config set <key> <value>

Argument	Description
`key`	The configuration key to set.
`value`	The value to assign to the key.

Set the Java path to a specific executable:

mcup config set java.path /usr/bin/java17

Enable developer tools:

mcup config set devtools.enabled true

Remove a specific configuration key and its value. This will revert the key to its default value if one exists.

mcup config remove <key>

Argument	Description
`key`	The configuration key to remove.

Remove the custom Java path setting:

mcup config remove java.path

Clear all user configuration settings, resetting them to defaults.

mcup config clear

List all current configuration keys and their values.

mcup config list