2 You can configure your instance from admin interface. You need account with admin rights and little change in config file, which will allow settings configuration from database.
5 config :pleroma, configurable_from_database: true
9 Settings are stored in database and are applied in `runtime` after each change. Most of the settings take effect immediately, except some, which need instance reboot. These settings are needed in `compile time`, that's why settings are duplicated to the file.
11 File with duplicated settings is located in `config/{env}.exported_from_db.exs` if pleroma is runned from source. For prod env it will be `config/prod.exported_from_db.exs`.
13 For releases: `/etc/pleroma/prod.exported_from_db.secret.exs` or `PLEROMA_CONFIG_PATH/prod.exported_from_db.exs`.
16 You need to migrate your existing settings to the database. This task will migrate only added by user settings.
17 For example you add settings to `prod.secret.exs` file, only these settings will be migrated to database. For release it will be `/etc/pleroma/config.exs` or `PLEROMA_CONFIG_PATH`.
18 You can do this with mix task (all config files will remain untouched):
21 ./bin/pleroma_ctl config migrate_to_db
24 ```sh tab="From Source"
25 mix pleroma.config migrate_to_db
28 Now you can change settings in admin interface. After each save, settings from database are duplicated to the `config/{env}.exported_from_db.exs` file.
30 <span style="color:red">**ATTENTION**</span>
32 **<span style="color:red">Be careful while changing the settings. Every inaccurate configuration change can break the federation or the instance load.</span>**
34 *Compile time settings, which require instance reboot and can break instance loading:*
35 - all settings inside these keys:
38 - partially settings inside these keys:
39 - `:seconds_valid` in `Pleroma.Captcha`
40 - `:proxy_remote` in `Pleroma.Upload`
41 - `:upload_limit` in `:instance`
43 ## How to dump settings from database to file
45 *Adding `-d` flag will delete migrated settings from database table.*
48 ./bin/pleroma_ctl config migrate_from_db [-d]
51 ```sh tab="From Source"
52 mix pleroma.config migrate_from_db [-d]
56 ## How to completely remove it
58 1. Truncate or delete all values from `config` table
60 TRUNCATE TABLE config;
62 2. Delete `config/{env}.exported_from_db.exs`.
67 cp config/prod.exported_from_db.exs config/exported_from_db.back
68 rm -rf config/prod.exported_from_db.exs
70 *If you don't want to backup settings, you can skip step with `cp` command.*
72 3. Set configurable_from_database to `false`.
74 config :pleroma, configurable_from_database: false
76 4. Restart pleroma instance
78 sudo service pleroma restart