-
Notifications
You must be signed in to change notification settings - Fork 8
Required Secrets
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
| License Type | Setup Section |
|---|---|
| Unity Personal (Free) | Personal License Setup |
| Unity Plus / Pro (Paid) | Professional License Setup |
| License Server | License Server 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:
-
Windows →
C:\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.ulffile. -
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!
Let’s build better Unity pipelines together! 🚀
Need help? Join the Discussions or open an Issue.