> ## Documentation Index
> Fetch the complete documentation index at: https://docs-freessh.vercel.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Connection Management

Manage saved SSH connections from **Home > Connections**.

## Edit Existing Connections

Use edit when a saved host changes (hostname, user, port, auth method, or key selection).

Good practice:

* Keep connection names stable (`prod-api-1`, `staging-db`)
* Encode environment in group, not only in name

## Profile Settings

Each connection also has a **Profile** tab for session defaults:

* `TERM` (preset or custom)
* Per-connection terminal font size
* Per-connection terminal theme
* Startup command
* Startup command delay (ms)

## Grouping Strategy

Use groups when your list starts growing.

Example structure:

* `Production`
* `Staging`
* `Development`
* `Personal`

This keeps search and scanning fast when you have many hosts.

## Move Connections Between Groups

You can move a saved connection without editing the form:

1. Open **Home > Connections**
2. Drag a connection card
3. Drop it on a group card

The connection is reassigned to that group immediately.

## Delete Behavior

Deleting a saved connection:

* Removes only local saved config
* Does **not** delete anything on remote servers
* Does not remove unrelated session logs/snippets automatically

## Troubleshooting

See [Connection Troubleshooting](/troubleshooting/connection-troubleshooting).