moonraker/user_changes.md at f616c83ebc4855d0c46e7ef3d6e630daec81f2c4

This file will track changes that require user intervention, such as a configuration change or a reinstallation.

The color_order option in the [wled] section has been deprecated. This is configured in wled directly. This is not a breaking change, the setting will simply be ignored not affecting functionality.

The password_file option in the [mqtt] section has been deprecated. Use the password option instead. This option may be a template, thus can resolve secrets stored in the [secrets] module.

Previously all core components received configuration through the [server] config section. As Moonraker's core functionality has expanded this is becoming unsustainable, thus core components should now be configured in their own section. For example, the config_path and log_path should now be configured in the [file_manager] section of moonraker.conf. See the configuration documentation for details. This is not a breaking change, core components will still fall back to checking the [server] section for configuration.

The [authorization] module is now a component, thus is only loaded if the user has it configured in moonraker.conf. This deprecates the previous enable option, as it is enabled if configured and disabled otherwise.
The API Key is now stored in the database. This deprecates the api_key_file option in the [authorization] module. Users can no longer read the contents of the API Key file to retrieve the API Key. Instead, users can run scripts/fetch-apikey.sh to print the API Key. Alternative a user can navigate to http://{moonraker-host}/access/api_key from a trusted client to retrieve the API Key.

The cors_domain option in the [authoriztion] section is now checked for dangerous entries. If a domain entry contains a wildcard in the top level domain (ie: http://www.*) then it will be rejected, as malicious website can easily reproduce this match.

The enable_debug_logging in the [server] section now defaults to False. This dramatically reduces the amount of logging produced by Moonraker for the typical user.

To enable Octoprint compatibility with slicer uploads it is now required to add [octoprint_compat] to moonraker.conf. After making this change it is necessary to restart the Moonraker service so the module is loaded.

The file manager no longer restricts the config_path to a folder within the HOME directory. The path may not be the system root, however it can reside anywhere else on the file system as long as Moonraker has read and write access to the directory. This applies to gcode path received from Klipper via the virtual_sdcard section as well.

The install script (install-moonraker.sh) now has command-line options:
-r Rebuild the python virtual env
-f Force an overwrite of /etc/default/moonraker during installation
-c /path/to/moonraker.conf Allows user to specify the path to moonraker.conf during configuration. Using this in conjunction with -f will update the defaults file wih the new path.
New dependencies have been added to Moonraker which require reinstallation. Run the following command to reinstall and rebuild the virtualenv:
```
  ~/moonraker/scripts/install-moonraker.sh -r
```
The power plugin configuration has changed. See the install guide for details on the new configuration.
Users transitioning from the previous version of the power plugin will need to unexport any curently used pins. For example, the following command may be used to unexport pin 19:
```
  echo 19 > /sys/class/gpio/unexport
```
Alternatively one may reboot the machine after upgrading:

cd ~/moonraker/ git pull ~/moonraker/scripts/install-moonraker.sh -r sudo reboot

Make sure that the power plugin configuration has been updated prior to rebooting the machine.