# Install Datashare

The installer will take care of checking that your system have all the dependencies to run Datashare. Because this software use [Apache Tesseract](https://github.com/tesseract-ocr/tesseract) (to perform Optical Character Recognition, OCR) and Mac doesn't support them out-of-box, heavy dependencies must be downloaded. If your system have none of those dependencies, the first installation of Datashare can take up to 30 minutes.

The installer will set up:

* **Xcode Command Line Tools** (if neither XCode or [Xcode Command Line Tools](https://mac.install.guide/commandlinetools/index.html) are installed)
* **Homebrew** (if neither Homebrew or MacPorts are installed)
* **Apache Tesseract** with MacPorts or Homebrew
* **Java JRE 17**
* **Datashare** executable

**Note:** Previous versions of this document referred to a "Docker Installer". We do not provide this installer anymore but Datashare is still [published on the Docker Hub](https://hub.docker.com/r/icij/datashare) and supported with Docker.

**Installation fails:**

* Error while installing Homebrew or MacPorts: you can manually install [Homebrew](https://brew.sh/) first and then restart the installer.
* "System Software from application was blocked from loading" : Check in your Mac's "System Settings" > "privacy & security" if you have a section with this mention "System software from application 'Datashare' was blocked from loading" or something similar related to Datashare. If you have this section you'll have to click "Allow" to be able to install datashare.
* For any other issue check our [Github issues](https://github.com/ICIJ/datashare/issues) or [create a new one](https://github.com/ICIJ/datashare/issues/new?template=bug_report.md) with your setup (macOs version) and installer logs (Command+L when the installer is launched and failed).

{% stepper %}
{% step %}

#### **Download Datashare**

Go to [datashare.icij.org](https://datashare.icij.org) and click '**Download for Mac'**.

<figure><img src="https://2881303961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWCyd3pDXO_H4jk9DgG%2Fuploads%2Fgit-blob-ce5165f5aea5df753ebe00fde2822a890ef87b19%2FDownload.png?alt=media" alt="Screenshot of the homepage of datashare.icij.org highlighting the &#x27;Download for Mac&#x27; button"><figcaption><p><a href="https://datashare.icij.org">datashare.icij.org</a></p></figcaption></figure>
{% endstep %}

{% step %}

#### Start the installer

In Finder, go to your '**Downloads'** directory and double-click '**datashare-X.Y.Z.pkg'**:

<figure><img src="https://2881303961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWCyd3pDXO_H4jk9DgG%2Fuploads%2Fgit-blob-d9e9e7a07f16e00f71977840d69df9c3a11c85b5%2FScreenshot%202023-01-13%20at%2002.45.34.png?alt=media" alt="Screenshot of the Downloads window on Mac showing the installer package of Datashare"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Go through the Datashare Installer**

Click '**Continue**', '**Install**', enter your password and '**Install Software**':

<figure><img src="https://2881303961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWCyd3pDXO_H4jk9DgG%2Fuploads%2Fgit-blob-3089190bda6b34d7b279a703383acfe8cfd2b80c%2FScreenshot%202023-01-13%20at%2002.46.08.png?alt=media" alt="Screenshot of the Mac installer&#x27;s first step to install Datashare: &#x27;Introduction&#x27;"><figcaption></figcaption></figure>

<figure><img src="https://2881303961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWCyd3pDXO_H4jk9DgG%2Fuploads%2Fgit-blob-81c8ef9e0e9d138875abc47e49ecf49aa96d9d67%2FScreenshot%202023-01-13%20at%2002.46.21.png?alt=media" alt="Screenshot of the Mac installer&#x27;s third step to install Datashare: &#x27;Installation Type&#x27;&#x27;"><figcaption></figcaption></figure>

<figure><img src="https://2881303961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWCyd3pDXO_H4jk9DgG%2Fuploads%2Fgit-blob-5db53165d884aa368013458007afac4bbbfb0f10%2FScreenshot%202023-01-13%20at%2002.47.01.png?alt=media" alt="Screenshot of the Mac installer&#x27;s step to install Datashare when username and password are asked"><figcaption></figcaption></figure>

The installation begins. You see a progress bar. It stays a long time on "Running package scripts" because it is installing XCode Command Line Tools, MacPort, Tesseract OCR, Java Runtime Environment and finally Datashare.

You can see what it actually does by typing command+L: it will open a window which logs every action made.

In the end, you should see this screen:

<figure><img src="https://2881303961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWCyd3pDXO_H4jk9DgG%2Fuploads%2Fgit-blob-7d2e506480aadbcf6fab4b0d5402d98d635e5721%2FScreenshot%202023-01-13%20at%2002.47.33.png?alt=media" alt="Screenshot of the Mac installer&#x27;s last step to install Datashare: &#x27;Summary&#x27; saying &#x27;The installation was successful.&#x27;with a blue &#x27;Close&#x27; button"><figcaption></figcaption></figure>

You can now safely close this window.
{% endstep %}
{% endstepper %}

You can now [start Datashare](https://icij.gitbook.io/datashare/local-mode/install-datashare-on-mac/open-datashare-on-mac).
