> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sampler.meiji.industries/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Meiji Sampler and understand the current platform support before you start.

# Installation and system requirements

## Platform support

* Meiji Sampler officially supports **macOS**, **Linux**, and **Windows**.
* **macOS** is the primary supported platform and is the most stable day to day.
* **Windows** and **Linux** are official targets as well; on Linux, stability can still depend on your audio backend and terminal setup.

## macOS install

The strongly recommended install method is the DMG from `sampler.meiji.industries`. It bundles a supported terminal with GPU acceleration and great fonts, includes a reliable auto-update mechanism, and is the preferred option for most users.

For terminal purists who want to run Meiji Sampler inside their own terminal, use the curl installer instead:

```bash theme={null}
curl -fsSL https://sampler.meiji.industries/install.sh | bash
```

## Linux install

Linux is supported, but you should expect more manual setup around audio host, devices, and latency.

Use a modern terminal, verify your output device, and be prepared to try a different backend if low-latency playback is unstable.

```bash theme={null}
curl -fsSL https://sampler.meiji.industries/install.sh | bash
```

## Windows install

Download the EXE installer from `sampler.meiji.industries`, or install via curl in PowerShell:

```powershell theme={null}
curl -fsSL https://sampler.meiji.industries/install.sh | bash
```

## What gets installed

Meiji Sampler stores state and configuration in your user directories.

* macOS session state: `~/Library/Application Support/Meiji Sampler/state.json`
* macOS settings: `~/Library/Application Support/Meiji Sampler/config.json`
* macOS projects: `~/Documents/Meiji Sampler/Projects/`

On Linux, state and settings live under `~/.config/meiji-sampler/`.

On Windows, state and settings live under `%APPDATA%\Meiji Sampler\`, and projects under `Documents\Meiji Sampler\Projects\`.

## Next step

Continue to [Terminal Compatibility](/start-here/terminal-compatibility) or go straight to [Audio Setup](/start-here/audio-setup).