summaryrefslogtreecommitdiff
path: root/docs/system/config-management.rst
blob: df2a80aaa283d63a7d5a1bef8325997fc14113e9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
.. _config-management:

########################
Configuration Management
########################

VyOS comes with an integrated versioning system for the system configuration.
The configurations are versioned locally for rollback but they can also be
stored on a remote host for archiving/backup reasons.

.. cfgcmd:: set system config-management commit-revisions <number>

   Change the number of commit revisions to `<number>`, the default setting for
   this value is to store 20 revisions locally.

.. cfgcmd:: set system config-management commit-archive location '<url>'

   If you want to save all config changes to a remote destination. Set the
   commit-archive location. Every time a commit is successfully the
   ``config.boot`` file will be copied to the defined destination(s). The
   filename used on the remote host used will be:
   ``config.boot-hostname.YYYYMMDD_HHMMSS``

   Destinations will be configured as any of the below :abbr:`URI (Uniform
   Resource Identifier)`

   * ``scp://<user>:<passwd>@<host>/<dir>``
   * ``sftp://<user>:<passwd>@<host>/<dir>``
   * ``ftp://<user>:<passwd>@<host>/<dir>``
   * ``tftp://<host>/<dir>``

.. note:: The number of revisions don't effect the commit-archive.