Skip to content

Required Secrets

Astrid Avalin Soerensen edited this page May 5, 2025 · 15 revisions

🔐 Unity License Setup for CI/CD

To run Unity builds and tests in this CI/CD pipeline, you must activate a Unity license for use inside GitHub Actions.

This guide explains how to prepare and securely store your Unity license, depending on your license type.

👉 Reference: GameCI Unity Activation Docs


🎮 Supported License Types

License Type Setup Section
Unity Personal (Free) Personal License Setup
Unity Plus / Pro (Paid) Professional License Setup
License Server License Server Setup

🏗️ Personal License Setup

Use this if you’re using the free Unity Personal license.

1️⃣ Activate Locally
On your machine, open Unity Hub → Preferences → Licenses → Add
Select Get a free personal license → Complete activation.

2️⃣ Locate .ulf File
After activation, find the license file:

  • WindowsC:\ProgramData\Unity\Unity_lic.ulf
  • macOS/Library/Application Support/Unity/Unity_lic.ulf
  • Linux~/.local/share/unity3d/Unity/Unity_lic.ulf

3️⃣ Add GitHub Secrets
Go to your repository → Settings → Secrets and variables → Actions → Secrets → Add:

  • UNITY_LICENSE → Paste the full contents of your .ulf file.
  • UNITY_EMAIL → Your Unity account email.
  • UNITY_PASSWORD → Your Unity account password.

✅ Done! Your CI/CD pipeline can now activate the license during test and build steps.


Unfortunately no support for pro-licenses as of now. Will come if I get the time... and the means to test it!

Clone this wiki locally