# OpenAI Codex SSH Configuration Example
# Place this file at: ~/.codex/ssh-config.toml
#
# This file contains SSH server configurations for MCP SSH Manager
# when used with OpenAI Codex.
#
# For Claude Code users: Use .env format instead (see .env.example)
# Production Server Example (using SSH key - RECOMMENDED)
[ssh_servers.production]
host = "prod.example.com"
user = "admin"
key_path = "~/.ssh/id_rsa" # Path to SSH private key
port = 22 # Optional, defaults to 22
default_dir = "/var/www/html" # Optional, default working directory
description = "Production web server" # Optional description
sudo_password = "sudo_pass" # Optional, for automated deployments
# Staging Server Example (using password authentication)
[ssh_servers.staging]
host = "staging.example.com"
user = "deploy"
password = "secure_password" # Use SSH keys instead when possible
port = 2222 # Custom SSH port
default_dir = "/home/deploy/app"
description = "Staging environment"
# Database Server Example
[ssh_servers.db_server]
host = "192.168.1.100"
user = "dbadmin"
key_path = "~/.ssh/db_key"
port = 22
default_dir = "/var/lib/mysql"
description = "MySQL database server"
# Development Server Example (minimal configuration)
[ssh_servers.dev]
host = "dev.example.com"
user = "developer"
key_path = "~/.ssh/dev_key"
# Docker Host Example
[ssh_servers.docker_host]
host = "docker.example.com"
user = "docker"
key_path = "~/.ssh/docker_key"
default_dir = "/opt/docker"
description = "Docker container host"
# Multiple Environment Examples
[ssh_servers.app_prod]
host = "app-prod.example.com"
user = "ubuntu"
key_path = "~/.ssh/aws_prod_key"
default_dir = "/var/www/myapp"
description = "App production server"
[ssh_servers.app_staging]
host = "app-staging.example.com"
user = "ubuntu"
key_path = "~/.ssh/aws_staging_key"
default_dir = "/var/www/myapp"
description = "App staging server"
# Notes:
# 1. key_path is RECOMMENDED over password for better security
# 2. Paths starting with ~ will be expanded to your home directory
# 3. default_dir is optional but recommended for convenience
# 4. sudo_password should only be used for trusted automation scenarios
# 5. All server names are case-insensitive and normalized to lowercase