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

# Blender

> Manual installation instructions for Speckle Blender connector via ZIP

<Warning>
  **This guide is for IT administrators only.** If you are a regular user, see our [Blender
  installation guide](/connectors/blender) instead.
</Warning>

<Info>
  **Install separately for each version**: Repeat these steps for each application version you want
  to use with Speckle.
</Info>

Connector versions \< 3.4.0 require the Speckle Desktop Services background service. [Learn more about Desktop Services](/connectors/manual-installation/desktop-services).
For versions ≥ 3.4.0; the desktop service is not required.

## Windows Installation

### Install for a single user

1. Extract the downloaded ZIP file and locate the `bpy_speckle` folder.
2. Copy the `bpy_speckle` folder.
3. Navigate to `%AppData%\Blender Foundation\Blender\{VERSION}\scripts\addons\`
   * Replace `{VERSION}` with your Blender version (example: `4.5`)
   * Create the directory if it doesn't exist
4. Paste the `bpy_speckle` folder into the `addons` directory.

### Install for all users

Use `%ProgramFiles%\Blender Foundation\Blender\{VERSION}\scripts\addons\` instead of `%AppData%\Blender Foundation\Blender\{VERSION}\scripts\addons\`

### Update the connector

To update to a new version, download the latest ZIP file and repeat the installation steps above. The new files will replace the existing ones.

### Uninstall the connector

Delete the `bpy_speckle` folder from your installation location.

To remove all Speckle products, also delete the `%AppData%\Speckle\` folder.

## macOS Installation

### Installing the connector

1. Open Blender.
2. Go to **Edit** > **Preferences** > **Add-ons**.
3. Click the down arrow next to the search box and select **Install from Disk**.
4. Select the downloaded ZIP file.
5. Enable the add-on by checking the box next to **Speckle**.

The connector is now installed and ready to use.

### Update the connector

To update to a new version, download the latest ZIP file and repeat the installation steps above. The new files will replace the existing ones.

### Uninstall the connector

1. Go to **Edit** > **Preferences** > **Add-ons**.
2. Find **Speckle** in the add-ons list.
3. Click the down arrow next to the checkbox and select **Remove**.

To remove all Speckle products, also delete the `~/Library/Application Support/Speckle/` folder.

<Card title="Back to manual installation overview" icon="arrow-left" href="/connectors/manual-installation/introduction">
  Return to connector selection
</Card>