> For the complete documentation index, see [llms.txt](https://jadelab.gitbook.io/jadegit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jadelab.gitbook.io/jadegit/0.18.0/developers/getting-started.md).

# Getting Started

The following steps cover manual installation of JadeGit, useful for getting started in a local development environment.  Developers of existing systems may want to skip ahead to look at [migration strategies](/jadegit/0.18.0/migration/overview.md) for adopting JadeGit.

## Installation

Download the [latest release](https://gitlab.com/jadelab/jadegit/-/releases) for the Jade platform version you're using, and copy the binaries into the bin folder of the database being setup.

Configure the database to use JadeGit for development by adding the following settings to the [Jade initialization file](https://secure.jadeworld.com/developer-centre/Jade2025/OnlineDocumentation/?#resources/jadeini/ch1jadeinifile/ch1jadeinifile.htm).

```ini
[JadeSecurity]
JadePatchControlSecurity=true
DevelopmentSecurityLibrary=jadegitdev
```

{% hint style="success" icon="lightbulb" %}
JadeGit can also be enabled or disabled by [specifying the INI settings as part of the command line parameters](https://secure.jadeworld.com/developer-centre/Jade2022/OnlineDocumentation/#resources/installconfig/ch2configuringjade/placing_initialization_file_parameters_on_the_command_line.htm) for a Jade shortcut (running in single-user mode).
{% endhint %}

## Sign On

On start up of the Jade IDE, the JadeGitSchema will be installed automatically during logon.

{% hint style="warning" %}
You may be shown an error about a missing MSVC library.  To fix this, you'll need to install the latest [Microsoft Visual C++ Redistributable for Visual Studio 2022](https://aka.ms/vs/17/release/vc_redist.x64.exe).
{% endhint %}

Following logon, the JadeGit Changes explorer appears to the right of the screen.  It cannot be closed directly and will be restarted if terminated, but may be minimized if preferred during development.

<figure><img src="/files/GJOmQD1H3YqEuiz91co4" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="screwdriver-wrench" %}
To keep both visible at the same time, the Jade IDE needs to be resized/positioned to the left of the JadeGit Changes explorer.  In future, this may be streamlined with JadeGit being integrated within the IDE, if [JEDI #383](https://jedi.ideas.jadeworld.com/ideas/JAD-I-383) is progressed.
{% endhint %}

## Multi-User Support

Due to a [platform limitation](https://jedi.ideas.jadeworld.com/ideas/JAD-I-402), JadeGit cannot be used in a traditional multi-user environment with multiple client nodes connecting to a remote database server.

However, JadeGit can be used with an application server running in single-user mode, which enables multiple developers to work in a shared environment with the IDE running in thin-client mode.

{% hint style="info" icon="screwdriver-wrench" %}
Further work is needed to support developers working on independent changes simultaneously within the same environment. Until then, all changes are tracked under the same branch.
{% endhint %}

{% hint style="info" icon="shuffle" %}
If changes need to be tested in multi-user mode during local development, the limitation above can be worked around by complementing single-user shortcuts for development with those needed to start the database server and client nodes in multi-user mode for testing (while the IDE isn't open).
{% endhint %}