This GitHub Action allows you to connect to a GitHub Actions runner via SSH for interactive debugging using ngrok.

It works with Ubuntu, macOS and Windows runners.

- name: Start SSH session
  uses: luchihoratiu/debug-via-ssh@main
  with:
    NGROK_AUTH_TOKEN: ${{ secrets.NGROK_AUTH_TOKEN }}
    SSH_PASS: ${{ secrets.SSH_PASS }}

• NGROK_AUTH_TOKEN - The authorization token received from ngrok. See FAQ section for more info.
• SSH_PASS - The password used for starting a SSH session. For Windows runners, this password must respect some minimum complexity requirements.

• NGROK_REGION - The region where the ngrok client will connect to host its tunnels. Defaults to us.
• NGROK_TIMEOUT - The max amount of time ngrok will host its tunnel. Defaults to 21500 (value is in seconds).

1. Go to https://ngrok.com/
2. Hit Sign up in the top right corner
3. Login via GitHub/Google or Sign up for a standalone account
4. From the given dashboard, you can now get your ngrok auth token

See https://ngrok.com/docs for latest information.

• us - United States
• eu - Europe
• ap - Asia/Pacific
• au - Australia
• sa - South America
• jp - Japan
• in - India