> ## 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.

# Disconnect and Reconnect

> How FreeSH handles broken SSH sessions and reconnection

When a remote session drops unexpectedly, FreeSH keeps the tab and shows a disconnect notification in the bottom-left.

## What You See

For unexpected disconnects:

* Session status becomes disconnected
* Notification shows the tab title
* Available actions:
* `Reconnect`
* `Close Tab`

For user-initiated disconnects:

* No reconnect notification is shown

## Reconnect Flow

1. Click `Reconnect` on the disconnect notification.
2. FreeSH reuses the saved connection configuration.
3. A new session is created and the existing tab is rebound to the new session.

If reconnect succeeds:

* Notification is removed
* Tab remains open with the reconnected terminal

If reconnect fails:

* Error toast is shown
* Notification remains, so you can retry or close tab

## Notes

* Workspace-contained sessions should also surface disconnect notifications.
* Tabs are not auto-closed on unexpected disconnect.

## Troubleshooting

See [Disconnect and Reconnect Troubleshooting](/troubleshooting/terminal-disconnect-reconnect-troubleshooting).