pleroma/docs/administration/CLI_tasks/config.md

154 lines
2.8 KiB
Markdown
Raw Normal View History

# Transfering the config to/from the database
{! backend/administration/CLI_tasks/general_cli_task_info.include !}
## Transfer config from file to DB.
!!! note
You need to add the following to your config before executing this command:
```elixir
config :pleroma, configurable_from_database: true
```
=== "OTP"
```sh
./bin/pleroma_ctl config migrate_to_db
```
=== "From Source"
```sh
mix pleroma.config migrate_to_db
```
## Transfer config from DB to `config/env.exported_from_db.secret.exs`
!!! note
In-Database configuration will still be applied after executing this command unless you set the following in your config:
```elixir
config :pleroma, configurable_from_database: false
```
2020-11-25 15:46:57 -08:00
To delete transferred settings from database optional flag `-d` can be used. `<env>` is `prod` by default.
=== "OTP"
```sh
./bin/pleroma_ctl config migrate_from_db [--env=<env>] [-d]
```
=== "From Source"
```sh
mix pleroma.config migrate_from_db [--env=<env>] [-d]
```
2020-11-25 15:49:36 -08:00
## Dump all of the config settings defined in the database
=== "OTP"
```sh
./bin/pleroma_ctl config dump
```
=== "From Source"
```sh
mix pleroma.config dump
```
## List individual configuration groups in the database
=== "OTP"
```sh
./bin/pleroma_ctl config groups
```
=== "From Source"
```sh
mix pleroma.config groups
```
2020-11-28 10:19:00 -08:00
## Dump the saved configuration values for a specific group or key
2020-11-25 15:49:36 -08:00
2020-11-28 10:19:00 -08:00
e.g., this shows all the settings under `config :pleroma`
2020-11-25 15:49:36 -08:00
=== "OTP"
```sh
2020-11-28 10:19:00 -08:00
./bin/pleroma_ctl config dump pleroma
2020-11-25 15:49:36 -08:00
```
=== "From Source"
```sh
2020-11-28 10:19:00 -08:00
mix pleroma.config dump pleroma
2020-11-25 15:49:36 -08:00
```
2020-11-25 15:51:31 -08:00
2020-11-28 10:19:00 -08:00
To get values under a specific key:
2020-11-25 15:51:31 -08:00
2020-11-28 10:19:00 -08:00
e.g., this shows all the settings under `config :pleroma, :instance`
2020-11-25 15:51:31 -08:00
=== "OTP"
```sh
2020-11-28 10:19:00 -08:00
./bin/pleroma_ctl config dump pleroma instance
2020-11-25 15:51:31 -08:00
```
=== "From Source"
```sh
2020-11-28 10:19:00 -08:00
mix pleroma.config dump pleroma instance
```
## Delete the saved configuration values for a specific group or key
e.g., this deletes all the settings under `config :tesla`
=== "OTP"
```sh
./bin/pleroma_ctl config delete [--force] tesla
2020-11-28 10:19:00 -08:00
```
=== "From Source"
```sh
mix pleroma.config delete [--force] tesla
2020-11-28 10:19:00 -08:00
```
To delete values under a specific key:
e.g., this deletes all the settings under `config :phoenix, :stacktrace_depth`
=== "OTP"
```sh
./bin/pleroma_ctl config delete [--force] phoenix stacktrace_depth
2020-11-28 10:19:00 -08:00
```
=== "From Source"
```sh
mix pleroma.config delete [--force] phoenix stacktrace_depth
2020-11-25 15:51:31 -08:00
```
## Remove all settings from the database
This forcibly removes all saved values in the database.
=== "OTP"
```sh
./bin/pleroma_ctl config [--force] reset
2020-11-25 15:51:31 -08:00
```
=== "From Source"
```sh
mix pleroma.config [--force] reset
2020-11-25 15:51:31 -08:00
```