renku config¶
Get and set Renku repository or global options.
Description¶
Save useful Renku configuration directives in a simple human-readable ini file. The values are used by other renku commands and by interactive sessions.
Check the Available configuration values section to get more information on the available values.
Commands and options¶
renku config¶
Interact with renku configuration.
renku config [OPTIONS] COMMAND [ARGS]...
remove¶
Remove a configuration value.
KEY is of the form <group>.<entry>, e.g. ‘interactive.default_url’.
renku config remove [OPTIONS] KEY
Options
- --global¶
Remove from global configuration only.
Arguments
- KEY¶
Required argument
set¶
Set a configuration value.
KEY is of the form <group>.<entry>, e.g. ‘interactive.default_url’.
renku config set [OPTIONS] KEY VALUE
Options
- --global¶
Store to global configuration only.
Arguments
- KEY¶
Required argument
- VALUE¶
Required argument
show¶
Show current configuration.
KEY is of the form <group>.<entry>, e.g. ‘interactive.default_url’.
renku config show [OPTIONS] [KEY]
Options
- --local¶
Read from local configuration only. NOTE: This argument is mutually exclusive with arguments: [–default, –global].
- --global¶
Read from global configuration only. NOTE: This argument is mutually exclusive with arguments: [–default, –local].
- --default¶
Show default values if applicable. NOTE: This argument is mutually exclusive with arguments: [–global, –local].
Arguments
- KEY¶
Optional argument
Examples¶
You can set various Renku configuration options, for example the image registry URL, with a command like:
$ renku config set interactive.default_url "/tree"
By default, configuration is stored locally in the project’s directory. Use
--global
option to store configuration for all projects in your home
directory.
To remove a specific key from configuration use:
$ renku config remove interactive.default_url
By default, only local configuration is searched for removal. Use --global
option to remove a global configuration value.
Available configuration values¶
The following values are used by renku-python and available for
the renku config
command:
Name |
Description |
Default |
---|---|---|
|
Whether to show messages about files being added to git LFS or not |
|
|
Threshold file size below which files are not added to git LFS |
|
|
Path to the data directory (read-only after project creation) |
|
|
Access token for Zenodo API |
|
|
Access token for Dataverse API |
|
|
URL for the Dataverse API server to use |
|
See the section on renku.ini for more configuration values.