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

# Installation

> Install TablePro via Homebrew or DMG on macOS 14.0+

# Installation

## System Requirements

* **macOS**: 14.0 (Sonoma) or later
* **Processor**: Apple Silicon (M1+) or Intel x86\_64
* **Memory**: 4 GB minimum (8 GB recommended)
* **Storage**: \~200 MB free disk space

TablePro uses native Apple frameworks only. No Java, .NET, or other runtimes needed.

## Install via Homebrew

The fastest option:

```bash theme={null}
brew install --cask tablepro
```

<Tip>
  Homebrew handles installation and updates in one place.
</Tip>

To update:

```bash theme={null}
brew upgrade tablepro
```

To uninstall:

```bash theme={null}
brew uninstall tablepro
```

To also remove application data:

```bash theme={null}
brew zap tablepro
```

## Download

### From GitHub Releases

1. Go to [GitHub Releases](https://github.com/TableProApp/TablePro/releases)
2. Download the DMG for your Mac:
   * **Apple Silicon (M1+)**: `TablePro-arm64.dmg`
   * **Intel**: `TablePro-x86_64.dmg`

Check your architecture: **Apple menu > About This Mac** → look for Chip (Apple Silicon) or Processor (Intel).

## Installation Steps

1. Open the DMG file (double-click)
2. Drag **TablePro** to the **Applications** folder shortcut

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

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/xXCKxj6nL9A5hobN/images/install-dmg-dark.png?fit=max&auto=format&n=xXCKxj6nL9A5hobN&q=85&s=456e9e3c7baac4bb736c3277eeb50457" alt="Drag to Applications" width="1200" height="800" data-path="images/install-dmg-dark.png" />
</Frame>

3. Eject the DMG (right-click > Eject)
4. Open **Finder > Applications** and launch **TablePro**

## Updating TablePro

TablePro checks for updates automatically via Sparkle. Check manually: **TablePro > Check for Updates...**.

Connections and settings persist across updates.

## Uninstallation

1. Quit TablePro
2. Drag **TablePro** from **Finder > Applications** to Trash

To delete all data (connections and history):

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

## Troubleshooting

**Crashes on launch**: Verify correct architecture, macOS 14.0+, and check Console.app for logs.

**Connection issues**: Confirm database server is running and not blocked by firewall.

See [Development Setup](/development/setup) for building from source.