Skip to content
play

GitHub Action

SSH Server

v1.0.0 Latest version

SSH Server

play

SSH Server

Expose an SSH server via ngrok that you can use to connect to your github runner

Installation

Copy and paste the following snippet into your .yml file.

              

- name: SSH Server

uses: mdelillo/ssh-server-action@v1.0.0

Learn more about this action in mdelillo/ssh-server-action

Choose a version

SSH Server Action

This action starts an SSH server and makes it available using ngrok. A free ngrok account will allow you to run a single SSH tunnel.

When the server is ready, you will see a message in your workflow output similar to the following:

To SSH to this runner: `ssh -i /path/to/private/key -p 11111 runner@0.tcp.ngrok.io`

Due to an issue with workflow output, you will only see the message if you were already viewing the workflow logs when the message was printed (or when the workflow finishes, but the server will no longer be running). In that case you can find the tunnel address on ngrok's status page.

Usage

See action.yml for a description of the options. A sample workflow showing how to run this action if a step fails can be found here.

steps:
- uses: mdelillo/ssh-server-action@v1
  with:
    ngrok-authtoken: "<your-ngrok-authtoken>"
    ssh-public-key: "ssh-rsa AAAAB3NzaC1yc2E..."