Discover how Edgegap works

Discover how Edgegap works

/

Unity Package Manager

/

Unity Package Manager

Deploy to Edgegap

Published

Published

Published

Last reviewed for accuracy

Last reviewed for accuracy

Last reviewed for accuracy

Unity Package Manager: How to install packages from a Git URL

Unity Package Manager: How to install packages from a Git URL

This guide shows you how to install a package in Unity straight from a Git repository, with the Package Manager window or by editing your project's manifest, and how to pin versions, install from a subfolder, reach private repositories and fix the common errors. We use Edgegap's Unity packages as the example; the steps work for any package hosted on Git.

Edgegap hosts multiplayer games on dedicated servers. Once your game server is containerized, Edgegap deploys it worldwide to 615+ Edge Cloud locations (on-demand) from a simple API call and billed exclusively on usage: no entire server to rent, provision or keep running between matches. For persistent servers of reserved capacity, Edgegap offers Private Fleets. Edgegap's Matchmaking builds on top of that and is optional.

Hosting a whole Unity game? See Unity Engine for the full path, from dedicated server build to matchmaking.

No credit card required. Free tier includes the resources to deploy a real game server.

No credit card required. Free tier includes the resources to deploy a real game server.

Step-by-Step Guide

Detailed Integration Steps

1. Before you start: install Git

Unity's Package Manager doesn't download Git packages itself: it runs the Git client installed on your computer.

  • Git 2.14.0 or newer, on your PATH. macOS usually has one already (Xcode Command Line Tools). On Windows, install Git and keep the installer's default option that adds Git to your PATH.

  • Restart Unity and Unity Hub after installing Git, so they see the new PATH.

  • Git LFS, only if the package stores large files with Git LFS. Without the LFS client, Unity checks out small pointer files instead of the real assets, with no error.

  • Any recent Unity version. The steps below use Unity 6.3 LTS.

Check it works: open a new terminal and run git --version.

2. Install a package from a Git URL in the Package Manager

  1. In Unity, open Window → Package Manager (Window → Package Management → Package Manager in newer Unity 6 versions).

  2. Select + at the top left, then Install package from git URL (called Add package from git URL in older versions).

  3. Paste the repository URL, ending in .git. For Edgegap's plugin: https://github.com/edgegap/edgegap-unity-plugin.git

  4. Select Install.

After a few seconds, the package appears in the list with a Git label. If it fails, the reason is in the Unity Console.

3. Or install it by editing manifest.json

Every package your project uses is listed in Packages/manifest.json. Adding a Git URL there does the same as the Package Manager, and is easy to share through version control or to ask a coding agent to do.

Open Packages/manifest.json and add a line under dependencies, with the package name as the key and the Git URL as the value:

"com.edgegap.unity-sdk": "https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5",

Save the file and return to Unity: it installs the package.

With your agent:

"Add the Edgegap Unity SDK 3.5.5 to this project from its Git URL in Packages/manifest.json."

Git URLs only go in your project's manifest.json, never in a package's own package.json.

4. Pin a version, update, or install from a subfolder

  • Pin a version: add # and a tag, branch or full commit hash to the URL, for example https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5. Short commit hashes don't work. Without #, you get the latest commit of the default branch.

  • Lock: Unity records the exact commit it installed, so your teammates get the same version. A branch name doesn't move forward on its own.

  • Update: install the same URL again from + → Install package from git URL, or change the # tag to a newer version.

  • Subfolder: if the package isn't at the root of the repository, add ?path= with the folder that holds its package.json, before any #: https://github.com/owner/repo.git?path=/MyPackage#v1.2.3. The reverse order fails.

  • Private repository: Unity can't ask for a password. Over HTTPS, set up a Git credential helper first. Over SSH (git@github.com:owner/repo.git), set up your SSH key outside Unity; a key protected by a passphrase only works through an agent such as ssh-agent.

5. Edgegap's Unity packages

  • Edgegap's automated game server build tool plugin for Unity: builds your Linux server, containerizes it and deploys it to the cloud from buttons in the Unity Editor. URL: https://github.com/edgegap/edgegap-unity-plugin.git. Open it under Tools → Edgegap Server Hosting.

  • Edgegap Unity SDK: the matchmaking client and server code your game uses at runtime. URL: https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5. Version 3.5.5 or newer is required for browser (WebGL) builds.

Using Mirror? Recent Mirror versions already include the Edgegap plugin (Assets/Mirror/Hosting/Edgegap). Don't install it again from Git, or Unity reports duplicate scripts.

6. Next: add matchmaking

With the Edgegap SDK installed, your game can group players and start a dedicated server near them automatically. See Unity Matchmaking SDK for the setup, or Unity Engine to start from your dedicated server build.

7. Check the install

  1. In the Package Manager, select In Project: the package is listed with a Git label and its version or commit.

  2. The Unity Console shows no Package Manager errors.

  3. For Edgegap's plugin, Tools → Edgegap Server Hosting opens the plugin window.

Frequently Asked Questions

Common questions about installing Unity packages from a Git URL.

How do I fix "No 'git' executable was found" in Unity?

Install Git 2.14.0 or newer and make sure it's on your PATH, then restart Unity and Unity Hub. On Windows, the Git installer's default option adds it to your PATH. Check with git --version in a new terminal.

How do I install a specific version of a Unity package from Git?

Add # and a tag, branch or full commit hash to the end of the Git URL, for example https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5. Without it, Unity installs the latest commit of the default branch.

How do I update a Unity package installed from Git?

Install the same Git URL again from the Package Manager's + menu, or change the version after # in Packages/manifest.json. Unity locks the commit it installed, so it doesn't update on its own.

Can Unity install a package from a private Git repository?

Yes. Unity can't ask for a password, so set up a Git credential helper for HTTPS, or an SSH key for SSH URLs, before you install. Passphrase-protected SSH keys need an agent such as ssh-agent.

Why do I get duplicate script errors after installing the Edgegap plugin?

Your project already contains the plugin, often because recent Mirror versions include it under Assets/Mirror/Hosting/Edgegap. Remove one copy: keep Mirror's, or remove that folder and use the Git package.

Clients

Learn more from clients who integrated Edgegap

31 case studies are available from studios that moved to Edgegap from another platform.

Key reasons why they chose Edgegap

Discover the impact of Edgegap's automated game server orchestration for a flawless multiplayer experience.

Cost

Pricing

Pricing

Optimize costs and performance with hybrid orchestration

Optimize costs and performance with hybrid orchestration

Optimize costs and performance with hybrid orchestration

Edge Cloud

On-Demand

$0.00115

/ vCPU

/ MINUTE

Billed by the Minute, Only on Usage

Pay only when players play. 0 active servers = $0

Deploy game servers worldwide, per instance, to all 615+ edge cloud locations. Zero commitment.

Simply add a credit card.

Edge Cloud

On-Demand

$0.00115

/ vCPU

/ MINUTE

Billed by the Minute, Only on Usage

Pay only when players play. 0 active servers = $0

Deploy game servers worldwide, per instance, to all 615+ edge cloud locations. Zero commitment.

Simply add a credit card.

Private Fleet (Bare Metal)

Reserved Capacity

$0.0261

/ vCPU

/ HOUR

Billed Monthly, Always On

$280 per host/month (12 mo rate), or $350 monthly

Optimize the cost effectiveness of your game server with egress-free hosting of Private Fleets.

Persistent, available 24/7, exclusive to your studio.

Private Fleet (Bare Metal)

Reserved Capacity

$0.0261

/ vCPU

/ HOUR

Billed Monthly, Always On

$280 per host/month (12 mo rate), or $350 monthly

Optimize the cost effectiveness of your game server with egress-free hosting of Private Fleets.

Persistent, available 24/7, exclusive to your studio.

Your bill varies per rate and usage; which can vary per game type, player count, & more.

Your bill varies per rate and usage; which can vary per game type, player count, & more.

Model your usage with our estimate calculator ->

Model your usage with our estimate calculator ->

Edgegap's features & price: detailed comparison between Edge Cloud & Private Fleets

Edgegap's features & price: detailed comparison between Edge Cloud & Private Fleets

COMPARE

Free Trial

Edge Cloud

Private Fleets

FEATURES

Analytics & Monitoring

Billing Alarms

Click to Expand

28 more rows

Unlocks

Capabilities are unlocked when a credit card is added to the account.

COMPARE

Free Trial

Edge Cloud

Private Fleets

FEATURES

Analytics & Monitoring

Billing Alarms

Click to Expand

28 more rows

Unlocks

Capabilities are unlocked when a credit card is added to the account.

COMPARE

Free Trial

Edge Cloud

Private Fleets

FEATURES

Analytics & Monitoring

Billing Alarms

Click to Expand

28 more rows

Unlocks

Capabilities are unlocked when a credit card is added to the account.