Skip to main content

​
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: 
    ldd ./seambridge | grep webkit
  2. If not installed, the user must install (depending on distro):
    • Ubuntu/Debian 
      sudo apt install libwebkit2gtk-4.0-37
    • Fedora 
      sudo dnf install webkit2gtk3
    • Arch 
      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. 
    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): 
      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.
  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 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:\ 
    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.