Skip to content
terminal

GitHub Action

SSH to GitHub Actions

v1.0.0 Latest version

SSH to GitHub Actions

terminal

SSH to GitHub Actions

Connect to GitHub Actions VM via SSH for interactive debugging

Installation

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

 
              
- name: SSH to GitHub Actions

              
  uses: P3TERX/ssh2actions@v1.0.0
Learn more about this action in P3TERX/ssh2actions

Choose a version

SSH to GitHub Actions

This GitHub Action offers you connect to GitHub Actions VM via SSH for interactive debugging

Features

  • Support Ubuntu and macOS
  • Provides two optional SSH connection methods, tmate and ngrok
  • Proceed to the next step to stay connected
  • Send SSH connection info to Telegram

Usage

Connect to Github Actions VM via SSH by using tmate

- name: Start SSH via tmate
  uses: P3TERX/ssh2actions@main
  # Send connection info to Telegram (optional)
  # You can find related documents here: https://core.telegram.org/bots
  env:
    TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
    TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}

Connect to Github Actions VM via SSH by using ngrok

- name: Start SSH via ngrok
  uses: P3TERX/ssh2actions@main
  with:
    mode: ngrok
  env:
    # After sign up on the https://ngrok.com
    # You can find this token here: https://dashboard.ngrok.com/auth/your-authtoken
    NGROK_TOKEN: ${{ secrets.NGROK_TOKEN }}
    
    # ngrok server region [us, eu, au, ap, sa, jp, in] (optional, default: us)
    # You can find this server region here: https://ngrok.com/docs#global-locations
    NGROK_REGION: us

    # This password you will use when authorizing via SSH
    SSH_PASSWORD: ${{ secrets.SSH_PASSWORD }}

    # Send connection info to Telegram (optional)
    # You can find related documents here: https://core.telegram.org/bots
    TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
    TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}

Lisence

MIT © P3TERX