# Installation

Get Treasure Studio running in under five minutes.

## Supported Platforms

| Platform | Architecture | Status |
|  --- | --- | --- |
| macOS | Apple Silicon (arm64) | Available |
| Windows | x64, arm64 | Upcoming |


Intel Mac Not Supported
Studio requires Apple Silicon (M1 or later). Intel-based Macs are not supported as Apple is deprecating them in 2026.

## Download and Install

1. Download the latest `.dmg` from the [GitHub Releases](https://github.com/treasure-data/tdx-studio/releases) page
2. Open the `.dmg` and drag **Treasure Studio** to Applications
3. Launch from Applications


## First Launch

On first launch, a setup wizard connects Studio to your Treasure Data account:

![Setup wizard](/assets/studio-setup-wizard.ccdfe736fd1bd963bc4a9b5a16fdd4988cf00380c7c7d111944b2314d99f23a7.5c07e18c.png)

1. **Region** — Select where your account lives (US, JP, EU, or AP)
2. **API Key** — Paste your TD API key


That's it. Your credentials are stored securely in the macOS Keychain. Studio is ready to use.

## Staying Up to Date

Studio checks for updates every time it launches. When a new version is available, it downloads silently in the background and applies on next restart.

![Update notification](/assets/studio-auto-update.d153bfec6ed607493c076c0215124bc756f0306d175d492db9b9e89138fefd49.5c07e18c.png)

Two release channels are available:

- **Stable** — Production-ready releases
- **Next** — Early access to upcoming features


## Data Location

Studio stores application data at:


```
~/Library/Application Support/Treasure Studio/
```

## Troubleshooting

### API key not accepted

Verify your key and region are correct by running:


```bash
tdx status
```

### Update stuck

If an auto-update fails, download the latest `.dmg` from GitHub Releases and install over the existing version.

### Keychain errors

If Studio can't access stored credentials, open **Keychain Access** and ensure the login keychain is unlocked.

## Next Steps

- [Introduction](/treasure-code/studio) — Learn what you can do with Studio
- [Concepts](/treasure-code/studio/concepts) — Understand projects, models, and credits