{"meta":{"title":"Installing Git Large File Storage","intro":"In order to use Git LFS, you'll need to download and install a new program that's separate from Git.","product":"Repositories","breadcrumbs":[{"href":"/en/repositories","title":"Repositories"},{"href":"/en/repositories/working-with-files","title":"Work with files"},{"href":"/en/repositories/working-with-files/managing-large-files","title":"Managing large files"},{"href":"/en/repositories/working-with-files/managing-large-files/installing-git-large-file-storage","title":"Install Git LFS"}],"documentType":"article"},"body":"# Installing Git Large File Storage\n\nIn order to use Git LFS, you'll need to download and install a new program that's separate from Git.\n\n<div class=\"ghd-tool mac\">\n\n1. Navigate to [git-lfs.com](https://git-lfs.com) and click **Download**. Alternatively, you can install Git LFS using a package manager:\n\n   * To use [Homebrew](https://brew.sh/), run `brew install git-lfs`.\n   * To use [MacPorts](https://www.macports.org/), run `port install git-lfs`.\n\n   If you install Git LFS with Homebrew or MacPorts, skip to step six.\n\n2. On your computer, locate and unzip the downloaded file.\n\n3. Open <span class=\"platform-mac\">Terminal</span><span class=\"platform-linux\">Terminal</span><span class=\"platform-windows\">Git Bash</span>.\n\n4. Change the current working directory into the folder you downloaded and unzipped.\n\n   ```shell\n   cd ~/Downloads/git-lfs-X.X.X\n   ```\n\n   > \\[!NOTE]\n   > The file path you use after `cd` depends on your operating system, Git LFS version you downloaded, and where you saved the Git LFS download.\n\n5. To install the file, run this command:\n\n   ```shell\n   $ ./install.sh\n   > Git LFS initialized.\n   ```\n\n   > \\[!NOTE]\n   > You may have to use `sudo ./install.sh` to install the file.\n\n6. Next, make required changes to your global Git config:\n\n   ```shell\n   $ git lfs install\n   > Git LFS initialized.\n   ```\n\n7. If you don't see a message indicating that `git lfs install` was successful, please contact us through the [GitHub Support portal](https://support.github.com). Be sure to include the name of your operating system.\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n1. Navigate to [git-lfs.com](https://git-lfs.com) and click **Download**.\n\n   > \\[!TIP]\n   > For more information about alternative ways to install Git LFS for Windows, see this [Getting started guide](https://github.com/github/git-lfs#getting-started).\n\n2. On your computer, locate the downloaded file.\n\n3. Double click on the file called *git-lfs-windows-1.X.X.exe*, where 1.X.X is replaced with the Git LFS version you downloaded. When you open this file Windows will run a setup wizard to install Git LFS.\n\n4. Open <span class=\"platform-mac\">Terminal</span><span class=\"platform-linux\">Terminal</span><span class=\"platform-windows\">Git Bash</span>. As the setup wizard may have modified your system `PATH`, opening a new session will ensure Git can locate Git LFS.\n\n5. Verify that the installation was successful:\n\n   ```shell\n   $ git lfs install\n   > Git LFS initialized.\n   ```\n\n6. If you don't see a message indicating that `git lfs install` was successful, please contact us through the [GitHub Support portal](https://support.github.com). Be sure to include the name of your operating system.\n\n</div>\n\n<div class=\"ghd-tool linux\">\n\n1. Navigate to [git-lfs.com](https://git-lfs.com) and click **Download**.\n\n   > \\[!TIP]\n   > For more information about alternative ways to install Git LFS for Linux, see this [Getting started guide](https://github.com/github/git-lfs#getting-started).\n\n2. On your computer, locate and unzip the downloaded file.\n\n3. Open <span class=\"platform-mac\">Terminal</span><span class=\"platform-linux\">Terminal</span><span class=\"platform-windows\">Git Bash</span>.\n\n4. Change the current working directory into the folder you downloaded and unzipped.\n\n   ```shell\n   cd ~/Downloads/git-lfs-1.X.X\n   ```\n\n   > \\[!NOTE]\n   > The file path you use after `cd` depends on your operating system, Git LFS version you downloaded, and where you saved the Git LFS download.\n\n5. To install the file, run this command:\n\n   ```shell\n   $ ./install.sh\n   > Git LFS initialized.\n   ```\n\n   > \\[!NOTE]\n   > You may have to use `sudo ./install.sh` to install the file.\n\n6. Next, make required changes to your global Git config:\n\n   ```shell\n   $ git lfs install\n   > Git LFS initialized.\n   ```\n\n7. If you don't see a message indicating that `git lfs install` was successful, please contact us through the [GitHub Support portal](https://support.github.com). Be sure to include the name of your operating system.\n\n</div>\n\n## Further reading\n\n* [Configuring Git Large File Storage](/en/repositories/working-with-files/managing-large-files/configuring-git-large-file-storage)"}