> ## Documentation Index
> Fetch the complete documentation index at: https://seam-feat-mintlify-migration-iteration.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Seam Bridge Setup for macOS
> Step-by-step instructions for installing, launching, and configuring Seam Bridge on macOS.
### System Requirements
* **Supported versions:**
* macOS 10.13 High Sierra or later
* Intel and Apple Silicon supported
* **Minimum hardware**
* 1 GB RAM
* \~200–300 MB disk space depending on bundle size
* **Network:** LAN connection required
***
## Run Seam Bridge
### Unzip and launch the app
1. Double click on the zipped file to unzip the file.
2. Try opening the SeamBridge.app by double-clicking it.
3. macOS will show a *“Seam Bridge" Not Opened* dialog.\\
4. Select **Done** to close the dialog.
### Approve the app in System Settings
1. Open **System Settings**.
2. Go to **Privacy & Security**.
3. Scroll to the bottom of the page.
4. Look for a message that says:
* *“Seam Bridge was blocked to protect your Mac.”*
5. Select **Open Anyway**.
6. Select **Open Anyway** in the popup.
{' '}
***
### Complete Seam Bridge setup
1. Accept the **Terms of Service.**
2. Enter a name for the site that you are connecting using Seam Bridge—for example, `My Site`—and then click **Start pairing**.
3. Seam Bridge displays a **Pairing code.** Use this code when connecting Seam Bridge to your workspace. Return to this window whenever a new pairing code is requested.
***
### Set up Seam Bridge to reboot on restarts
Use `launchd` to keep the Seam Bridge running on macOS. A LaunchAgent restarts the app if it crashes and starts it whenever the user logs in.
#### Create and Launch the LaunchAgent file
1. Open **Terminal**.
2. Create a plist file in your user `LaunchAgents` directory:
```bash theme={null}
mkdir -p ~/Library/LaunchAgents
nano ~/Library/LaunchAgents/com.seambridge.keepalive.plist
```
3. Paste this template:
```xml theme={null}
Labelcom.myapp.keepaliveProgramArguments/path/to/app/SeamBridge.app/Contents/MacOS/SeamBridgeKeepAliveRunAtLoad
```
4. Replace `/path/to/app` with the actual path to your binary/script. Keep the `/Contents/MacOS/SeamBridge` path at the end.
5. To save your changes in Nano:
* `Ctrl X` to Exit.
* `Y` to save changes.
* Confirm the file name and click **Enter**.
6. Within terminal, paste the following command to launch the launch agent:
```bash theme={null}
launchctl load ~/Library/LaunchAgents/com.seambridge.keepalive.plist
```
#### Test the setup
1. Kill the app manually.
2. `launchd` should restart it automatically.
3. Restart your Mac and confirm the app launches on login.
#### Prevent sleep from killing your app
1. Go to **System Settings** → **Battery**.
2. Set **Turn display off** as desired but disable **sleep while plugged in**.
***
4. Select **Done** to close the dialog.
### Approve the app in System Settings
1. Open **System Settings**.
2. Go to **Privacy & Security**.
3. Scroll to the bottom of the page.
4. Look for a message that says:
* *“Seam Bridge was blocked to protect your Mac.”*
5. Select **Open Anyway**.
6. Select **Open Anyway** in the popup.
3. Seam Bridge displays a **Pairing code.** Use this code when connecting Seam Bridge to your workspace. Return to this window whenever a new pairing code is requested.
***
### Set up Seam Bridge to reboot on restarts
Use `launchd` to keep the Seam Bridge running on macOS. A LaunchAgent restarts the app if it crashes and starts it whenever the user logs in.
#### Create and Launch the LaunchAgent file
1. Open **Terminal**.
2. Create a plist file in your user `LaunchAgents` directory:
```bash theme={null}
mkdir -p ~/Library/LaunchAgents
nano ~/Library/LaunchAgents/com.seambridge.keepalive.plist
```
3. Paste this template:
```xml theme={null}