---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/lfs.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/lfs.md
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt

# Настроить поддержку Git Large File Storage (LFS) в репозитории SourceCraft

<!-- source: ru/_includes/sourcecraft/lfs-description.md -->
Репозитории в SourceCraft поддерживают спецификацию [Git Large File Storage (LFS)](https://git-lfs.com/) для хранения больших файлов. Рекомендуем использовать LFS для размещения в репозитории объектов размером более 100 МБ.
<!-- endsource: ru/_includes/sourcecraft/lfs-description.md -->

1. Клонируйте репозиторий SourceCraft:

    {% list tabs %}

    - HTTPS

      <!-- source: ru/_includes/sourcecraft/clone-repo-pat.md -->
      1. [Установите Git](https://git-scm.com/downloads).
      1. На странице репозитория в правом верхнем углу нажмите кнопку <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M1.867 6.097a.75.75 0 0 1 1.036-.23L8 9.111l5.097-3.244a.75.75 0 0 1 .806 1.266l-5.5 3.5a.75.75 0 0 1-.806 0l-5.5-3.5a.75.75 0 0 1-.23-1.036" clip-rule="evenodd"/></svg> **Клонировать**.
      1. Скопируйте <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M12 2.5H8A1.5 1.5 0 0 0 6.5 4v1H8a3 3 0 0 1 3 3v1.5h1A1.5 1.5 0 0 0 13.5 8V4A1.5 1.5 0 0 0 12 2.5M11 11h1a3 3 0 0 0 3-3V4a3 3 0 0 0-3-3H8a3 3 0 0 0-3 3v1H4a3 3 0 0 0-3 3v4a3 3 0 0 0 3 3h4a3 3 0 0 0 3-3zM4 6.5h4A1.5 1.5 0 0 1 9.5 8v4A1.5 1.5 0 0 1 8 13.5H4A1.5 1.5 0 0 1 2.5 12V8A1.5 1.5 0 0 1 4 6.5" clip-rule="evenodd"/></svg> ссылку для клонирования репозитория из поля **HTTPS**.
      1. В терминале выполните команду:

          ```bash
          git clone <ссылка_для_клонирования_репозитория>
          ```

      1. Введите произвольное имя пользователя.
      1. В качестве пароля укажите [персональный токен](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/pat.md#create).

          {% note tip %}

          Если вы не хотите каждый раз вводить имя пользователя и пароль, используйте следующую команду:

          ```bash
          git clone https://anyname:<персональный_токен>@git.sourcecraft.dev/<слаг_организации>/<слаг_репозитория>.git
          ```

          {% endnote %}

      1. Перейдите в склонированный репозиторий:

         ```bash
         cd <имя_репозитория>
         ```
      <!-- endsource: ru/_includes/sourcecraft/clone-repo-pat.md -->

    - SSH

      <!-- source: ru/_includes/sourcecraft/clone-repo-ssh.md -->
      1. [Установите Git](https://git-scm.com/downloads).
      1. На странице репозитория в правом верхнем углу нажмите кнопку <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M1.867 6.097a.75.75 0 0 1 1.036-.23L8 9.111l5.097-3.244a.75.75 0 0 1 .806 1.266l-5.5 3.5a.75.75 0 0 1-.806 0l-5.5-3.5a.75.75 0 0 1-.23-1.036" clip-rule="evenodd"/></svg> **Клонировать**.
      1. Скопируйте <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M12 2.5H8A1.5 1.5 0 0 0 6.5 4v1H8a3 3 0 0 1 3 3v1.5h1A1.5 1.5 0 0 0 13.5 8V4A1.5 1.5 0 0 0 12 2.5M11 11h1a3 3 0 0 0 3-3V4a3 3 0 0 0-3-3H8a3 3 0 0 0-3 3v1H4a3 3 0 0 0-3 3v4a3 3 0 0 0 3 3h4a3 3 0 0 0 3-3zM4 6.5h4A1.5 1.5 0 0 1 9.5 8v4A1.5 1.5 0 0 1 8 13.5H4A1.5 1.5 0 0 1 2.5 12V8A1.5 1.5 0 0 1 4 6.5" clip-rule="evenodd"/></svg> ссылку для клонирования репозитория из поля **SSH**.
      1. В терминале выполните команду:
          
          ```bash
          git clone <ссылка_для_клонирования_репозитория>
          ```

          Чтобы склонировать репозиторий через порт 443, укажите номер порта в URL:

          ```bash
          git clone ssh://ssh.sourcecraft.dev:443/<слаг_организации>/<слаг_репозитория>.git
          ```

          Например:

          ```bash
          git clone ssh://ssh.sourcecraft.dev:443/sourcecraft/sourcecraft.git
          ```

          Подробнее об использовании SSH через порт HTTPS в [документации на GitHub](https://docs.github.com/en/authentication/troubleshooting-ssh/using-ssh-over-the-https-port).

      1. Перейдите в склонированный репозиторий:
          
         ```bash
         cd <имя_репозитория>
         ```
      <!-- endsource: ru/_includes/sourcecraft/clone-repo-ssh.md -->

    {% endlist %}

1. [Установите](https://github.com/git-lfs/git-lfs#installing) утилиту `git-lfs`.
1. Включите поддержку LFS в репозитории:

    ```bash
    git lfs install
    ```

1. Скопируйте в репозиторий файлы, которые вы хотите хранить в LFS.
1. Укажите, какие файлы должны храниться в LFS, разделяя перечисляемые файлы пробелом:

    ```bash
    git lfs track "<путь_к_большому_файлу_1>" "<путь_к_большому_файлу_2>" "<путь_к_большому_файлу_n>"
    ```

    {% note tip %}

    Также вы можете указать шаблоны файлов, которые должны храниться в LFS, например `git lfs track "*.png"`.

    {% endnote %}

1. Добавьте файлы для отслеживания в git, сделайте коммит и отправьте изменения в удаленный репозиторий:

    ```bash
    git add .
    git commit -m "added LFS objects"
    git push origin main
    ```

#### Полезные ссылки {#see-also}

* [Взаимосвязь ресурсов SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md)
* [Импортировать репозиторий](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/migration.md)
* [Предложить изменения](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/pr-create.md)
