---json
{
    "aliases": [
        { "path": ":docs:conf:variable_file" },
        { "path": ":docs:connection:vault" }
    ],
    "low_quality_page": "false",
    "page_id": "tolx54t1e4mfb0i75vixb"
}
---
====== Tabulify - Configuration Vault (.tabli.yml) ======


===== About =====
The ''configuration vault'' is a [[docs:conf:conf|configuration file]] named ''.tabli.yml'' that stores:

  * [[..:connection:connection|connections]]
  * and [[global|global parameters]]


===== Location =====

By default:
  * the file is searched recursively from the working directory 
  * if not found, the path is in the user ''%%$HOME\.tabli%%'' directory.


You can get the location of the configuration vault with the [[docs:tabli:attribute:list|variable list command]].
<unit>
<code bash>
tabli attribute list conf
</code>
<console>
key                     value
---------------------   -----------------------------------------
conf                    C:\Users\userName\.tabli\.tabli.yml
</console>
</unit>



===== Cli Command =====

Advanced user will modify the file directly with a text editor but
for convenience, we provide also:

  * the [[docs:tabli:connection:start|Tabli Connection module]]
  * the [[docs:tabli:attribute:start|Tabli Attribute module]]


In every [[docs:tabli:tabli|tabli command]], you can specify the location of this file with:

  * the ''%%--conf%%'' [[docs:tabli:global|global option]].
  * or the ''TABLI_CONF'' [[docs:conf:os|OS environment variable]]


===== Secret =====

The configuration vault supports [[docs:conf:secret|secrets]] as value.


You can:
  * encrypt any value with [[docs:tabli:vault:encrypt|vault encrypt]]
  * or define environment variables as value
===== Format =====


<code yaml .tabli.yml>
# List of global attributes
globals:
  key1: value
  key2: value
# List of connections
connections:
  connectionName1:
    # uri
    uri: uri
    # description
    description: description
    # user
    user: user
    # password
    password: ${MY_PASSWORD}
    # Native Driver extra attributes
    natives:
      # for example, for jdbc sql driver
      applicationName: myName
  connectionName2:
    uri: xxx
</code>