# Seam Bridge Setup for Linux

## System Requirements

### Supported distributions

Ubuntu, Debian, Fedora, Arch, OpenSUSE, and most Linux desktops that include WebKitGTK.

### Runtime dependencies

WebKitGTK 3 or 4

1. Check if installed:

   ```bash
   ldd ./seambridge | grep webkit
   ```
2. If not installed, the user must install (depending on distro):
   * **Ubuntu/Debian**

     ```bash
     sudo apt install libwebkit2gtk-4.0-37
     ```
   * **Fedora**

     ```bash
     sudo dnf install webkit2gtk3
     ```
   * **Arch**

     ```bash
     sudo pacman -S webkit2gtk
     ```

### Minimum hardware

* 1 GB RAM
* \~150 MB disk space
* x64 architecture
* LAN Network access

***

## Run Seam Bridge

### Launch the app and allow required permissions

1. Open the downloaded Seam Bridge file.
2. If it does not open, you may need to mark it as executable.

   ```bash
   chmod +x ./seambridge
   ```
3. Launch the app:

   ```
   ./seambridge
   ```
4. If the app does not start due to permissions, you may need to allow it through your system’s security settings:

   * Some Linux distributions block files downloaded from the internet.
   * If this happens, remove the quarantine attribute (if present):

     ```bash
     xattr -d com.apple.quarantine ./seambridge
     ```

   *(On most Linux systems this won’t appear, but it’s safe to run.)*
5. If your Linux system prompts you to allow the app to access the network, approve the request so Seam Bridge can connect to your on-premises system.
6. Seam Bridge will launch.

***

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

   ![](/files/btNSgpyurWFGcIboM1cQ)
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.

   ![](/files/mAGsU9d5IzSQj9JbNlwB)

***

### Set up Seam Bridge to reboot on restart

Use `systemd` to keep an app running on Linux. It supervises the process, restarts it on crash, and handles boot startup.

#### Create a systemd service file

1. Open Terminal.
2. Create the service file:\\

   ```bash
   sudo nano /etc/systemd/system/SeamBridge.service
   ```
3. Add this template:

   ```
   [Unit]
   Description=Seam Bridge - Keep Running
   After=network.target

   [Service]
   ExecStart=/usr/local/bin/SeamBridge.exe
   Restart=always
   RestartSec=3
   WorkingDirectory=/usr/local/bin
   User=ubuntu
   Environment=NODE_ENV=production

   [Install]
   WantedBy=multi-user.target
   ```
4. Replace paths and `User` as needed.

#### Enable and start the service

1. Within Terminal, run the following commands:

```
sudo systemctl daemon-reload
sudo systemctl enable SeamBridge.service
sudo systemctl start SeamBridge.service
```

#### Verify status

1. Run the following command in Terminal to confirm that the service is running:

```
systemctl status SeamBridge.service
```

You should see the service running and supervised.

#### Test auto-restart

1. Kill the process manually with `pkill SeamBridge`.
2. `systemd` should restart it immediately.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.seam.co/latest/capability-guides/seam-bridge/seam-bridge-setup-for-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.