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

# Link a Folder

> Connect a local repo folder to a Ghostable project so Desktop can find the manifest and schema files.

<Card title="Read the shared project model" icon="circle-info" href="/fundamentals/v2/core-objects/projects">
  The linked folder is the local companion to the shared Ghostable project record.
</Card>

## Why Link a Folder

Linking a folder lets Desktop find local, non-secret project files such as:

* `.ghostable/ghostable.yaml`
* `.ghostable/schema.yaml`
* `.ghostable/schemas/*.yaml`

Desktop needs that local context for validation, manifest sync, and file export workflows.

## How to Link

1. Open the project window.
2. Go to **Settings**.
3. Find the **Local Folder** section.
4. Click **Link Folder** and choose the project directory.

After the link is saved, Desktop shows the selected folder path and, when present, the manifest
path.

{/* ghostable:screenshot-output desktop-link-folder-project-settings:start */}

<img className="block dark:hidden w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/project-settings-local-folder-light.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=707f4ddd37ed2212605260fb5e80294e" alt="Ghostable desktop project settings view showing the linked local folder path and manifest path for the Control Plane project." width="2080" height="1384" data-path="images/generated/screenshots/ghostable-desktop/project-settings-local-folder-light.png" />

<img className="hidden dark:block w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/project-settings-local-folder-dark.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=f82ac2d9c055a9bec17a69535ff6b20b" alt="Ghostable desktop project settings view showing the linked local folder path and manifest path for the Control Plane project." width="2080" height="1384" data-path="images/generated/screenshots/ghostable-desktop/project-settings-local-folder-dark.png" />

## What You Unlock

* validation from the Project window,
* manifest sync,
* exporting `.env` files back into the repo,
* opening the folder or manifest directly from Project Settings.

## Continue

<CardGroup>
  <Card title="Sync the manifest" icon="arrows-rotate" href="/desktop/v1/local-integration/manifest-sync">
    Keep the local Ghostable manifest aligned with the project metadata.
  </Card>

  <Card title="Import and export env files" icon="folder-open" href="/desktop/v1/local-integration/import-export-env-files">
    Use the linked folder for local `.env` workflows.
  </Card>
</CardGroup>
