Skip to content

Debugging on another computer

Jump to bottom
Peter Chapman edited this page Oct 1, 2024 · 5 revisions

If you are using Windows or Linux, and want to run and debug Scripture Forge on macOS or iOS, you can use OpenSSH port forwarding to run Scripture Forge on your developer workstation and access it on macOS as if it is running locally.

Setup on Developer Workstation

On Windows 11:

  1. Open Settings
  2. Select System in the left hand menu
  3. Select Optional Features in the list
  4. Click View Features
  5. Install OpenSSH Server
  6. Open the Services Administrative Tool
  7. Start OpenSSH SSH Server

On Linux:

  • Install the openssh-server package and allow port 22 through your firewall. This is done on most distros automatically?

Note down your workstation's IP address and start Scripture Forge before proceeding.

Accessing from macOS

On macOS:

  1. Open Terminal

  2. Run:

    ssh -L 5000:localhost:5000 -L 5003:localhost:5003 -L 4200:localhost:4200 -L 9320:localhost:9320 <your-windows-username>@<windows-ip>

You will now be able to access Scripture Forge from Safari on macOS, or Safari in the iOS Simulator running from Xcode.

TCP/IP Port Explanation

  • 4200 Angular Debugging
  • 5000 Scripture Forge HTTP Server
  • 5003 Realtime Server
  • 9230 Node Debugging
Clone this wiki locally