# Oxygen for Mac Installation

To download Oxygen for Mac, the project Github page:

{% embed url="<https://github.com/oxygenhq/oxygen-ide/releases/latest>" %}

Click on the link for the DMG file. In the screenshot below that would be "oxygen-1.17.0-osx-x64.dmg"

![](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6BpsJKmuhEUbnf_vtF%2F-M6BuyMYNHrotFNmLaD3%2FOxygen%20Github.png?alt=media\&token=f53c4dba-abf3-4ca0-b7a5-f034fcdb151f)

After the file downloads, open the dmg file by double clicking it.

Click and drag the Oxygen icon to the shortcut icon for the Applications folder.

![](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6BwJewmkzn0sQm3z0g%2F-M6Bze_Tl3Wb0yoa_BYo%2FOxygen%20Mac%20Installation.png?alt=media\&token=a94f2759-00e5-43da-ae50-36e2bd3bbd5e)

As detailed in the [Oxygen CLI documentation page](https://docs.oxygenhq.org/download-installation-start/download-and-installation/cli-installation). you have to install the Oxygen framework from the Terminal in order to have the benefit of being able to execute Oxygen from test suites. (multiple sets of tests)

From the MacOS / Finder Spotlight Search, type Terminal.

![](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6Bztsruac-syWzHqpy%2F-M6C4HBSuCqnWnZ_5izv%2FSearching%20for%20Terminal%20in%20Spotligh%20search.png?alt=media\&token=0badb613-2625-4977-ba0b-5c539a560201)

![](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6Bztsruac-syWzHqpy%2F-M6C6nioI7I53MNxGUpZ%2FTerminal%20icon.png?alt=media\&token=569e2340-808c-42b0-820c-b3607f2d8bff)

A pre-requisite for installing Oxygen CLI and running it via the terminal, is having Node.js installed, which also includes NPM.

Go to the [Node.JS downloads page here. ](https://nodejs.org/en/download/)Choose the macOS Installer (.pkg) - 64-bit download or simply click on the macOS Installer

![Node.js downloads page](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6Bztsruac-syWzHqpy%2F-M6CIFOA5ahSQeiMdMfk%2FNode.JS%20downloads%20page.png?alt=media\&token=1e594e62-c38c-4af9-a028-5c2cb0737fef)

Go through the steps to install Node.js by launching the Node installation package. This installer will install both Node.js and NPM.&#x20;

![](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6Bztsruac-syWzHqpy%2F-M6CONHh03JoV_6W2q3A%2Fnode.js%20installation%20package.png?alt=media\&token=1c035d36-40d9-4c19-bb92-19fd2ae03d02)

![](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6COUvdE0KcgJy53OO3%2F-M6COgR7KRyq_1Pzz7Bk%2Fnode.js%20installation%20-%20start.png?alt=media\&token=d88858db-4725-4170-8e06-b2d75ca6d436)

![](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6COvmf50FIvQno8iL-%2F-M6CQ9EKF1-0DyH3gNMw%2Finstall%20node.js%20-%20summary.png?alt=media\&token=8bbb4634-3ef0-40a5-ab5f-342766343121)

After installation has complete, verify the successful installation of NPM by typing "npm" without the quotes in the Terminal window.

![](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M6COvmf50FIvQno8iL-%2F-M6CQYZBGzzKrS3L-vFm%2Finstalling%20Oxygen-CLI%20using%20npm%20in%20Terminal.png?alt=media\&token=f6f71091-f49b-44b3-959b-1f36cdbb8019)

If NPM is successfully installed, to install Oxygen-CLI you can enter:

```
sudo npm install -g oxygen-cli
```

or

```
npm install -g oxygen-cli
```

sudo is used to elevate permissions (super-user do), if the current user had limited permissions.

At this point, npm will install Oxygen-CLI on the system.

You can confirm successful installation by typing Oxygen on the terminal prompt

```
oxygen
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oxygenhq.org/download-installation-start/download-and-installation/oxygen-for-mac-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.