To use the version of Git™ provided with projects, when you add a project to source control or
retrieve from source control, select
Git in the
Source control tool list.
If you add an existing project to Git source control, you create a local Git repository in that sandbox. You can specify a remote repository later. See Add a Project to Source Control.
If you want to clone a remote Git repository to create a project, on the MATLAB® Home tab, select New > Project > From Git. After you specify a remote repository to clone, a local repository is created. You can also pull, fetch, and push changes to and from the remote repository. See Clone Git Repository.
To use a Git server for your remote repository, you can use a Git server hosting solution or set up your own
Git server. If you cannot set up a server and must use a remote
repository via the file system using the
protocol, make sure it is a bare repository with no working copy checked
To make your project publicly available on GitHub®, see Share Project on GitHub. Sharing adds Git source control to the open project and the project’s remote repository is GitHub.
Starting in R2020b, you do not need to install command-line Git to fully use Git with MATLAB. You can now merge branches using the built-in Git integration.
To setup Git for releases before R2020b, see https://www.mathworks.com/help/releases/R2020a/simulink/ug/set-up-git-source-control.html.
Several operations, such as committing, merging, and receiving pushed commits, use Git Hooks. To use Git Hooks on Windows® with MATLAB, install Cygwin and add it to the MATLAB library path:
Download the installer from https://www.cygwin.com/. Run the installer.
In the MATLAB Command Window, type
Add the Cygwin bin folder location to the end of
librarypath.txt, for example,
If you do not have permission to edit the
librarypath.txt file, create a copy and save it
to your MATLAB start folder.
Restart MATLAB for the changes to take effect.
You can clone a remote repository like GitHub and GitLab™ using HTTPS or SSH. To prevent frequent login
prompts when you interact with your remote repository using HTTPS, add a new public
key and clone the repository using SSH instead. To avoid problems connecting using
SSH, set the
HOME environment variable and use it to store your
SSH keys. For more information, see Use SSH Authentication with MATLAB.
For new projects under Git source control, MATLAB automatically registers your binary files to prevent corruption when merging. For existing projects, register the binary files before using Git to merge branches. For more information, see Register Model Files with Git.
If you are working with long path files, run this command in MATLAB:
!git config --global core.longpaths true
To prevent frequent login prompts when you interact with your remote repository using HTTPS, add a new public key and clone the repository using SSH instead.
Git integration uses the user
HOME environment variable
to locate the
.ssh folder containing SSH keys. If the
HOME environment variable is not set or the SSH keys are not
stored properly, you will encounter problems using SSH to connect to remote
repositories like GitHub and GitLab.
To use SSH authentication inside MATLAB:
ssh-keygen to generate valid SSH keys. In the
Generating public/private rsa key pair. Enter file in which to save the key (C:\Users\username/.ssh/id_rsa): Created directory 'C:\Users\username/.ssh'. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in C:\Users\username/.ssh/id_rsa. Your public key has been saved in C:\Users\username/.ssh/id_rsa.pub. The key fingerprint is: SHA256:/Nc9/tnZ7Dmh77+iJMxmPVrlPqaFd6J1j1YRXEk3Tgs company\username@us-username
ssh-keygenconfirms where to save the key (for example,
.ssh/id_rsa) and asks for a passphrase. If you do not want to type a password when you use the key, leave the passphrase empty. If you already have keys in the specified folder,
ssh-keygenasks if you want to override them.
It is not possible to generate SSH keys directly in MATLAB. Generate SSH keys using the
ssh-keygen provided with a command-line
Place your keys in the
HOME/.ssh folder. To verify
HOME directory the MATLAB
Git integration is working with, in the MATLAB Command Window, enter:
getenv('HOME') returns nothing, you need to set
HOME environment variable.
To set the
HOME environment variable in Windows:
In the Start Search box, search for and select "advanced system settings".
On the Advanced tab, click Environment Variables.
In the User Variables section, click
New. Create the
HOME environment variable and specify its
HOME environment variable is always set on
Linux® and Mac.
Configure your GitHub or GitLab account to use the SSH keys:
Copy the contents of
.pub file in the
Paste the contents in the Add SSH key field in the SSH keys section of your account settings.
You can prevent Git from corrupting your Simulink® models by registering binary files in your
For new projects and projects that switched from another source control
system, MATLAB automatically creates a
and populates it with a list of binary files to register. This specifies
that Git should not make automatic line feed, diff, and merge attempts
for registered files.
For existing projects, create a
.gitattributes file and
populate it with the list of binary files to register.
In the Command Window, type:
Add a line to the attributes file for each file type you need.
You can copy a
.gitattributes file that
contains the list of common binary files to
Restart MATLAB so you can start using the Git client.
You can reduce your Git repository size by saving Simulink models without compression. Turning off compression results in larger SLX files on disk but reduces repository size.
To use this setting with new SLX files, create your models using a model template with SLX Compression set to none. For existing SLX files, set compression and then save the model. For more information, see Set SLX Compression Level.