Workspace Persistence and Database Locations

docs/src/workspace-persistence.md

6dbfa93ed65190532fb417f763a37cdcc455549234b920a90000000300000425

# Workspace Persistence

Zed creates local SQLite databases to persist data relating to its workspace and your projects. These databases store, for instance, the tabs and panes you have open in a project, the scroll position of each open file, the list of all projects you've opened (for the recent projects modal picker), etc. You can find and explore these databases in the following locations:

- macOS: `~/Library/Application Support/Zed`
- Linux and FreeBSD: `~/.local/share/zed` (or within `XDG_DATA_HOME` or `FLATPAK_XDG_DATA_HOME`)
- Windows: `%LOCALAPPDATA%\Zed`

The naming convention of these databases takes on the form of `0-<zed_channel>`:

- Stable: `0-stable`
- Preview: `0-preview`

**If you encounter workspace persistence issues in Zed, deleting the database and restarting Zed often resolves the problem, as the database may have been corrupted at some point.** If your issue continues after restarting Zed and regenerating a new database, please [file an issue](https://github.com/zed-industries/zed/issues/new?template=10_bug_report.yml).

Chunks

eefdadce (1st chunk of `docs/src/workspace-persistence.md`)

Title: Workspace Persistence and Database Locations

Summary

Zed uses SQLite databases to persist workspace and project data, such as open tabs, scroll positions, and recent projects. These databases are located in platform-specific directories and are named according to the Zed channel (e.g., stable or preview). Deleting and regenerating the database can often resolve workspace persistence issues.