# macOS

{% hint style="info" %}
If you don't know where to get the game files for the version you want to play yet - check out the [How to acquire data files?](https://doukutsu-rs.gitbook.io/docs/getting-started/how-to-acquire-data-files) guide before following instructions here.
{% endhint %}

### 1. Download doukutsu-rs

* Go to the doukutsu-rs downloads page: [**https://get.doukutsu.rs**](https://get.doukutsu.rs)
* Choose either the **Apple Silicon (ARM64)** version or the **Intel (x86\_64)** depending on [the type of your processor](https://support.apple.com/116943). All Macs made since 2024 have an Apple silicon processor.

As with most Mac programs, it is recommended that you store the application file (`dokutsu-rs.app`) in either the global or user `Applications` directory on your computer.

### 2. Add Game Data

* Right-click on the downloaded application (`dokutsu-rs.app`) and click `Show Package Contents`.
* Inside the application, navigate to `Contents/Resources/` and place the Cave Story game data directory in the folder. The data directory is a folder named "**data**" in the original game files.
* If you are using freeware data files downloaded from the tribute site, place the original `Doukutsu.exe` executable near the doukutsu-rs executable file in `Contents/MacOS/`. After the first run you will get a **«No stage table found»** or **«Texture "Loading" is missing»** error. Copy all files from the `Contents/MacOS/data/` folder to the `Contents/Resources/data/` folder and delete `Contents/MacOS/data/`.

Note that due to the self-contained nature of Mac applications, this will have to be repeated if a newer version is downloaded.

### 3. Authorise application

Modern Mac computers [only permit software that has been signed and notarised to run by default](https://support.apple.com/en-nz/102445). As of this writing, dokutsu-rs is not notarised. To grant permission for it run:

* Open the application. A notice will be displayed that dokutsu-rs does not have permission to run.
* Open System Preferences and select Privacy and Security settings.
* Scroll down to the bottom and authorise dokutsu-rs by selecting `Open Anyway`. The application can now be opened normally in the future.

### Updating doukutsu-rs to a Newer Version

* Updating doukutsu-rs is very easy! When a new version is released, simply download the new `.app` program file from the [downloads page](https://get.doukutsu.rs) (just like you did in Step 1).
* **Important:** Make sure doukutsu-rs is completely closed before updating.
* Once downloaded, repeat Step 2 with the new application file you downloaded. The extant application can then be replaced if desired.
* **Your settings and save files are safe!** Updating only replaces the program itself. Your game settings and saved games are stored separately ([#where-are-the-saves-settings-logs](https://doukutsu-rs.gitbook.io/docs/faq#where-are-the-saves-settings-logs "mention")), so they will not be affected by updating the program file.

**Setup Complete!**

You are now ready to play doukutsu-rs. Run `doukutsu-rs.app` to start the game. Enjoy!

***

If you have any questions about installing or using doukutsu-rs, please re-read the setup guide and check [FAQ](https://doukutsu-rs.gitbook.io/docs/faq). If you still can't find the answer to your question, feel free to ask it on [Github issues](https://github.com/doukutsu-rs/doukutsu-rs/issues/new/choose) or on [the project's Discord server](https://discord.gg/fbRsNNB).