1
0
mirror of https://github.com/rancher/os.git synced 2025-06-25 22:41:36 +00:00
os/docs/rancherctl-config.md
2015-04-02 12:39:28 -07:00

60 lines
1.6 KiB
Markdown

# rancherctl config
`rancherctl config` is used to manipulate the configuration of RancherOS stored
in `/var/lib/rancher/conf/rancher.yml`. You are still free to edit that file
directly, but by using `rancherctl config` it is safer and often more convenient.
For all changes to configuration, you must reboot for them to take effect.
## Sub commands
| Command | Description |
|----------|-------------------------------------------------|
| get | get value |
| set | set a value |
| import | import configuration from standard in or a file |
| export | export configuration |
| merge | merge configuration from stdin |
## Examples
Set a simple value in the `rancher.yml`
rancherctl config set user_docker.tls true
Set a list in the `rancher.yml`
rancherctl config set network.dns.nameservers '[8.8.8.8,8.8.4.4]'
Get a simple value in `rancher.yml`
rancherctl config set user_docker.tls true
Import the `rancher.yml` from a file
rancherctl config import -i local-rancher.yml
Export the `rancher.yml` to a file
rancherctl config export -o local-rancher.yml
Dump the full configuration, not just the changes in `rancher.yml`
rancherctl config export --full
Dump the configuration, including the certificates and private keys
rancherctl config export --private
Merge in a configuration fragment
```bash
rancherctl config merge << "EOF"
network:
dns:
nameservers:
- 8.8.8.8
- 8.8.4.4
EOF
```