Add a Server
Server Fields
Click + ADD SERVER in the left sidebar. Fill in the fields:
| Field | Required | Description |
|---|---|---|
| Name | Yes | Display label (e.g. prod-web-01) |
| Host | Yes | IP address or hostname |
| Port | Yes | Default 22 |
| Username | Yes | SSH user on the remote server |
| Auth Method | Yes | Password or SSH key |
| Password | If password auth | Stored encrypted in vault |
| Private Key | If key auth | PEM or OpenSSH format |
| Passphrase | If key + passphrase | Stored encrypted in vault |
| Remember password | No | If off, prompts each session and never persists |
Auth Methods
Password Auth
Paste or type your password. If Remember password is on (default), it's stored in the AES-256-GCM vault. If off, KoreShell prompts on each connect and discards after the session ends.
SSH Key Auth
Supported formats:
- RSA (2048, 4096):
-----BEGIN RSA PRIVATE KEY----- - Ed25519 (recommended):
-----BEGIN OPENSSH PRIVATE KEY----- - ECDSA:
-----BEGIN EC PRIVATE KEY-----
Click the file picker to load a key from disk, or paste the key contents directly.
:::tip Generate a new key Use KoreShell's built-in key generator: Settings → SSH Keys → Generate Key. Choose Ed25519 for best security. The public key is automatically available to copy to your server. :::
Adding a Public Key to a Server
# From your local machine
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@your-server
# Or manually append to authorized_keys
cat ~/.ssh/id_ed25519.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
Or use KoreShell SSH Keys manager to do this from within the app.
Editing & Deleting Servers
- Edit: right-click a server card → Edit, or open server → top bar → ⋯ → Edit
- Delete: right-click → Delete. This removes the server and its stored credentials from the vault.
Export / Import
Right-click a server → Export to save a JSON file (credentials are stripped — only host/port/user). Use Import in the sidebar to load it on another machine, then re-enter credentials.