Skip to content

Installing JunctionRelay on Unraid

This guide walks you through installing JunctionRelay from Unraid's Community Applications (CA).

Prerequisites

  • Unraid 6.8.0 or later
  • Community Applications plugin installed
  • Administrative access to your Unraid server

Installation Steps

1. Access Community Applications

  1. Log into your Unraid web interface

  2. Navigate to the Apps tab in the main menu

Note: If you don't see the Apps tab, follow the instructions here

2. Search for JunctionRelay

  1. In the Apps tab, use the search bar at the top
  2. Type JunctionRelay and press Enter
  3. Look for the JunctionRelay application in the search results

Search

3. Install JunctionRelay

  1. Click on the JunctionRelay application card
  2. Review the application details and description
  3. Click the Install button
  4. The Docker container template will open

Install

4. Configure Installation Settings

The following settings should auto-populate, but customize as needed

Basic Settings

  • Name: JunctionRelay
  • Repository: catapultcase/junctionrelay:latest
  • Network Type: Select host (recommended) or bridge depending on your setup

Port Configuration

  • Host Mapping: Default port is 7180 - change if this port is already in use

Volume Mappings

Configure the following path mappings:

Container Path Host Path Description
/dev /dev This will allow JunctionRelay to access COM devices on the host. Depending on your setup, you may need to also enable 'Privileged' mode
/app/data /mnt/user/appdata/junctionrelay Default path is /mnt/user/appdata/junctionrelay but change as needed

Template

5. Complete Installation

  1. Review all settings to ensure they're correct
  2. Click Apply to start the installation
  3. Unraid will download the Docker image and create the container
  4. Wait for the installation to complete

Post-Installation

Accessing JunctionRelay

  1. Once installation is complete, you can access JunctionRelay via:
  2. WebUI: Click the JunctionRelay icon in the Docker tab and click WebUI
  3. Direct URL: http://YOUR_UNRAID_IP:7180 (replace with your actual IP)

Troubleshooting

Common Issues

Container won't start:

  • Check the logs for error messages
  • Verify port conflicts with other containers
  • Ensure volume paths exist and have correct permissions

Can't access WebUI:

  • Verify the port mapping is correct
  • Check if the port is blocked by firewall
  • Ensure the container is running

Updating JunctionRelay

To update to the latest version:

  1. Go to the Docker tab
  2. Click the JunctionRelay container icon
  3. Select Update Container
  4. Follow the prompts to pull the latest image

Uninstalling

To remove JunctionRelay:

  1. Stop the container in the Docker tab
  2. Click the container icon and select Remove
  3. Optionally, delete the appdata folder when prompted