README.md

Setup Coder

Downloads and authenticates Coder's CLI with your Coder server. This action can be used to run authenticated Coder commands in GitHub Action workflows.

Usage

Create a GitHub secret named CODER_SESSION_TOKEN with your coder session token You can generate a long lived session token by running the following command in your browser console while logged into Coder with a Template Admin or Owner role.

  coder token create --lifetime 8760h --name "GitHub Actions"

jobs:
  setup-coder:
    runs-on: ubuntu-latest
    steps:
      - name: Setup Coder
        uses: coder/setup-action@v1
        with:
          access_url: 'https://coder.example.com'
          coder_session_token: ${{ secrets.CODER_SESSION_TOKEN }}

Inputs

Name	Description	Default
access_url	Required The url of coder deployment (e.g. https://coder.example.com).	-
coder_session_token	Required The session token of coder.	-