Config File
Understand and manually edit the Ternux config.yaml file.
All Ternux settings are persisted in a single config.yaml file. You can view and edit it directly from Settings → Config File, or open it in your preferred text editor.
File location
| Platform | Path |
|---|---|
| macOS | ~/Library/Application Support/ternux/config.yaml |
| Linux | ~/.config/ternux/config.yaml |
| Windows | %APPDATA%\ternux\config.yaml |
Top-level structure
groups:
- id: "uuid"
name: "Production"
parent: null # null = root level
connections:
- id: "uuid"
label: "Web Server"
host: "192.168.1.10"
port: 22
username: "admin"
auth_method: "vault" # "password" | "key" | "vault"
vault_id: "uuid" # set when auth_method = "vault"
key_id: "uuid" # set when auth_method = "key"
group_id: "uuid"
os: "ubuntu"
snippets:
- id: "uuid"
name: "Restart Nginx"
command: "sudo systemctl restart nginx"
tags: ["nginx", "deploy"]
appearance_settings:
theme: "dark" # "dark" | "light" | "system"
color_scheme: "default" # "default" | "one-dark-pro"
terminal_settings:
font_family: "Menlo, monospace"
font_size: 14
scrollback: 1000
cursor_style: "block"
cursor_blink: true
shortcuts:
spotlight: "cmd+k"
new_terminal: "cmd+t"
# ... etc
vault_blob: # AES-256-GCM encrypted blob (do not edit manually)
ciphertext: "base64..."
nonce: "base64..."
salt: "base64..."Editing manually
You can edit any section except vault_blob — manual changes to the encrypted blob will corrupt your vault. All other sections are plain YAML and safe to modify.
After saving your changes, Ternux reloads the config automatically (if the app is open, restart it to pick up changes made outside the app).
Backing up
Copy config.yaml to a safe location. This single file contains all your connections, groups, snippets, and settings. The vault_blob is portable — it decrypts with the same vault password on any machine.
Importing / migrating
To migrate to a new machine, copy config.yaml to the same path on the new machine. Set your vault password and all connections, snippets, and settings will be available immediately.