Skip to content

A GitHub Action to activate a Unity Game Engine license for CI/CD workflows

License

Notifications You must be signed in to change notification settings

buildalon/activate-unity-license

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

Buildalon Activate Unity License

Discord marketplace actions

A GitHub Action to activate a Unity Game Engine license for CI/CD workflows.

How to use

This action uses your stored environment secrets to authenticate with the Unity Licensing servers.

It's important that you disable other forks of your repository to run actions in pull requests from unknown contributors.

Read more on Approving workflow runs from public forks

Managing GitHub Actions settings for a repository

inputs

This action requires several secrets that need to be setup in the repository or organization's action secret store.

  • UNITY_USERNAME: The email address you use for your Unity Id.
  • UNITY_PASSWORD: The password you use for Unity Id access.
  • UNITY_SERIAL: The Serial number for the seat.
  • UNITY_SERVICES_CONFIG: Unity License Client services-config.json encoded as base64 string.

Important

Don't forget that Professional licenses only support 2 activations at a time!

name description required
license Must be one of Personal, Professional, or Floating Defaults to Personal
username The email address you use for your Unity Id Required for Personal and Professional license activations
password The password you use for Unity Id access Required for Personal and Professional license activations
serial The Serial number for the seat Required for Professional license activations
configuration Unity License Client services-config.json encoded as base64 string Required for Floating license activations

workflow

steps:
  - uses: buildalon/activate-unity-license@v1
    with:
      license: 'Personal' # Choose license type to use [ Personal, Professional, Floating ]
      username: ${{ secrets.UNITY_USERNAME }}
      password: ${{ secrets.UNITY_PASSWORD }}
      # serial: ${{ secrets.UNITY_SERIAL }} # Required for pro activations
      # configuration: ${{ secrets.UNITY_SERVICES_CONFIG }} # Required for floating license activations