> ## Documentation Index
> Fetch the complete documentation index at: https://ngquct-docs-fix-500-query-results.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install TablePro via Homebrew or DMG on macOS 14.0+

Homebrew is the short route: `brew install --cask tablepro` picks the build that matches your Mac. Everyone else takes the DMG, and that is the one route where you match the architecture yourself.

## System requirements

* **macOS**: 14.0 (Sonoma) or later
* **Architecture**: Apple Silicon (M1 or later) or Intel x86\_64

Native Apple frameworks only, so there is no Java or .NET runtime to install first. The download is about 20 MB.

## Homebrew

```bash theme={null}
brew install --cask tablepro    # install
brew upgrade tablepro           # update
brew uninstall tablepro         # remove the app
brew uninstall --zap tablepro   # remove the app and its data
```

## The DMG

<Steps>
  <Step title="Download the asset for your Mac">
    Release assets carry the version and the architecture: `TablePro-<version>-arm64.dmg` and `TablePro-<version>-x86_64.dmg`. Check which you need under **Apple menu > About This Mac**, where Chip means Apple Silicon and Processor means Intel. Both are on [GitHub Releases](https://github.com/TableProApp/TablePro/releases).
  </Step>

  <Step title="Drag it to Applications">
    Open the DMG and drag **TablePro** onto the **Applications** shortcut.

    <Frame caption="Drag TablePro to Applications">
      <img className="block dark:hidden" src="https://mintcdn.com/ngquct-docs-fix-500-query-results/HJY892UtvXUv1PFn/images/install-dmg.png?fit=max&auto=format&n=HJY892UtvXUv1PFn&q=85&s=572803903a86ac966ff41f1722c508d7" alt="Drag to Applications" width="1200" height="800" data-path="images/install-dmg.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/ngquct-docs-fix-500-query-results/HJY892UtvXUv1PFn/images/install-dmg-dark.png?fit=max&auto=format&n=HJY892UtvXUv1PFn&q=85&s=2941eae1fd51063d136de84ff2e91597" alt="Drag to Applications" width="1200" height="800" data-path="images/install-dmg-dark.png" />
    </Frame>
  </Step>

  <Step title="Eject, then launch">
    Right-click the mounted disk and choose **Eject**. Open **TablePro** from the Applications folder.
  </Step>
</Steps>

## Updates

Update checks run on their own. Force one with **TablePro > Check for Updates…**. Connections and settings survive an update.

## Removing it

Quit TablePro and drag it from the Applications folder to the Trash. To take the local data with it, which is connections, query history, and any driver plugins you installed:

```bash theme={null}
rm -rf ~/Library/Application\ Support/TablePro
rm ~/Library/Preferences/com.TablePro.plist
```

Connection passwords are in the macOS Keychain and survive both commands. Delete them in Keychain Access by searching for `com.TablePro`. Data already synced through iCloud stays in your iCloud account.

Building from source is in [Development Setup](/development/setup). A launch that fails or a connection that will not open is in [Troubleshooting](/troubleshooting).