Connect to your first database and run a query on macOS
With no connections saved, the welcome window offers Open Sample Database, a bundled Chinook SQLite file that needs no server and drops you at step 4. Reset it any time from Help > Reset Sample Database….
1
Install TablePro
brew install --cask tablepro, or the DMG from GitHub Releases. See Installation. The first launch shows a welcome sheet; click Continue to reach the welcome window, and choose Help > Getting Started to see it again.
2
Create a connection
Click New Connection… in the welcome window, pick a type in the Choose a Database sheet, then click Continue. A type badged Not Installed downloads its driver before the form opens, with no restart.
Pick a database type
Already have a connection URL, another client’s connections, or a repository with a .env? The Import menu under New Connection… takes all three. See Switching to TablePro.
3
Fill in the form, test it, save it
The host pre-fills to localhost and the port to the engine’s default. Username is optional: leave it empty and the database applies its own default. SQLite asks for a .sqlite or .db file instead of a host, with no credentials.
PostgreSQL connection form
Click Test Connection on the bar along the bottom. It turns into Connected with a green checkmark. Now click Save & Connect beside it.
Test Connection succeeded
The window switches to the main layout: databases and tables in the sidebar, the open tab in the middle, the inspector on the right.
A failed attempt paints the window with the driver’s own message and a Try Again button instead. Troubleshooting sorts refused from timed out.
4
Run a query
Click a table in the sidebar to browse it. For SQL, press Cmd+T for a query tab, type, and press Cmd+Enter to run the statement under the cursor.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"TablePro","description":"Database guides for TablePro on macOS, iPhone and iPad, and Linux beta. Windows is in development.","colors":{"primary":"#A85A00","light":"#FFBB6B","dark":"#A85A00"},"logo":{"light":"https://mintcdn.com/ngquct/6U84YfHWHIioid_B/logo/light.png?fit=max\u0026auto=format\u0026n=6U84YfHWHIioid_B\u0026q=85\u0026s=e0fe9a9794d4820c6bdb38a45e5ecca8","dark":"https://mintcdn.com/ngquct/6U84YfHWHIioid_B/logo/dark.png?fit=max\u0026auto=format\u0026n=6U84YfHWHIioid_B\u0026q=85\u0026s=65c0767194e0620e4772314e246f344a","href":"https://tablepro.app"},"favicon":"https://mintcdn.com/ngquct/4-1nHvwkx5S8kUx5/favicon.png?fit=max\u0026auto=format\u0026n=4-1nHvwkx5S8kUx5\u0026q=85\u0026s=fe963aab6cebfeb313d6517ea291d1cb","navbar":{"links":[{"href":"https://tablepro.app","label":"Website"},{"href":"https://github.com/TableProApp/TablePro","type":"github"}],"primary":{"type":"button","label":"Download","href":"https://tablepro.app/download"}},"footer":{"socials":{"website":"https://tablepro.app","x":"https://x.com/tableproapp","github":"https://github.com/TableProApp/TablePro","discord":"https://discord.gg/hCNmUUbnD4","telegram":"https://t.me/tablepro_app","facebook":"https://www.facebook.com/tableproapp"}},"search":{"prompt":"Search the docs"},"seo":{"metatags":{"og:site_name":"TablePro","og:type":"website","twitter:card":"summary_large_image"},"organization":{"id":"https://tablepro.app/#organization","name":"TablePro","url":"https://tablepro.app","sameAs":["https://github.com/TableProApp/TablePro"]},"indexing":"navigable"},"fonts":{"family":"Inter"},"integrations":{"ga4":{"measurementId":"G-GQYNPKSK83"},"cookies":{"key":"tablepro:analytics-consent","value":"granted"}},"errors":{"404":{"redirect":false,"title":"That page moved or never existed","description":"Try [the docs home](/), or search with `Cmd+K`. If a link here sent you, [open an issue](https://github.com/TableProApp/TablePro/issues)."}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/TableProApp/TablePro"},{"anchor":"Download","icon":"download","href":"https://tablepro.app/download"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/hCNmUUbnD4"},{"anchor":"Telegram","icon":"telegram","href":"https://t.me/tablepro_app"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ngquct","hasAudioNarration":false,"actualSubdomain":"ngquct","customDomains":["docs.tablepro.app"],"gitSource":{"type":"github","owner":"tableproapp","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"}},"buildId":"6af447762a7230ffd7ac4403","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"macOS","count":129},{"language":"default","tag":"Databases","count":45},{"language":"default","tag":"Connections","count":15},{"language":"default","tag":"Developers","count":15},{"language":"default","tag":"Schema and server","count":12},{"language":"default","tag":"API reference","count":11},{"language":"default","tag":"Write SQL","count":9},{"language":"default","tag":"Start here","count":8},{"language":"default","tag":"Browse and edit data","count":7},{"language":"default","tag":"Around the app","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"[email protected]","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"quickstart","slug":"/quickstart","pageMetadata":{"title":"Quickstart on macOS","description":"Connect to your first database and run a query on macOS","href":"/quickstart"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect to your first database and run a query on macOS\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Check,CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Tip}=_components;if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`With no connections saved, the welcome window offers `,_jsx(_components.strong,{children:`Open Sample Database`}),`, a bundled Chinook SQLite file that needs no server and drops you at step 4. Reset it any time from `,_jsx(_components.strong,{children:`Help > Reset Sample Database…`}),`.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Install TablePro`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`brew install --cask tablepro`}),`, or the DMG from GitHub Releases. See `,_jsx(_components.a,{href:`/installation`,children:`Installation`}),`. The first launch shows a welcome sheet; click `,_jsx(_components.strong,{children:`Continue`}),` to reach the welcome window, and choose `,_jsx(_components.strong,{children:`Help > Getting Started`}),` to see it again.`]})}),_jsxs(Step,{title:`Create a connection`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`New Connection…`}),` in the welcome window, pick a type in the `,_jsx(_components.strong,{children:`Choose a Database`}),` sheet, then click `,_jsx(_components.strong,{children:`Continue`}),`. A type badged `,_jsx(_components.strong,{children:`Not Installed`}),` downloads its driver before the form opens, with no restart.`]}),_jsxs(Frame,{caption:`Pick a database type`,children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser.png?fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=ad95b8ab115abe89f0dcfb7e300fef4d`,alt:`Database type chooser`,\"data-og-width\":`1400`,width:`1400`,\"data-og-height\":`964`,height:`964`,\"data-path\":`images/database-type-chooser.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser.png?w=280\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=ab8f4f89bde11efa1af49441606684c0 280w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser.png?w=560\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=41a19b09d948288313f4c50842eeade0 560w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser.png?w=840\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=531a26cf087fc47421cc5eea8acf0d91 840w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=1227b7ce68b780550a32c87c43e40d41 1100w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=c8e9adf88809792ac25501005e5a5f74 1650w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=b1a8ba9c080d10ea78eecfa6c7ab0694 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser-dark.png?fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=567ba53d6882f7924c6804d35934eaf0`,alt:`Database type chooser`,\"data-og-width\":`1400`,width:`1400`,\"data-og-height\":`964`,height:`964`,\"data-path\":`images/database-type-chooser-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=b88a55725c89ad1fe8585173704a2258 280w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=ab37e64886ab39d68348be364ba012b9 560w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=57e0235a20108e7197e614a21674779e 840w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=f246be42b6042558ee8fa49d70cee68b 1100w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=8b240ee266eaf7b8f01500581d0f55df 1650w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=3e7b659356ec165ce3b1f24fe4266d47 2500w`})]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`Already have a connection URL, another client’s connections, or a repository with a `,_jsx(_components.code,{children:`.env`}),`? The `,_jsx(_components.strong,{children:`Import`}),` menu under `,_jsx(_components.strong,{children:`New Connection…`}),` takes all three. See `,_jsx(_components.a,{href:`/switching`,children:`Switching to TablePro`}),`.`]})})]}),_jsxs(Step,{title:`Fill in the form, test it, save it`,children:[_jsxs(_components.p,{children:[`The host pre-fills to `,_jsx(_components.code,{children:`localhost`}),` and the port to the engine’s default. Username is optional: leave it empty and the database applies its own default. SQLite asks for a `,_jsx(_components.code,{children:`.sqlite`}),` or `,_jsx(_components.code,{children:`.db`}),` file instead of a host, with no credentials.`]}),_jsxs(Frame,{caption:`PostgreSQL connection form`,children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general.png?fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=181421700655bff4aca037d34b251805`,alt:`Connection form`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`1224`,height:`1224`,\"data-path\":`images/connection-form-general.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general.png?w=280\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=58e2e485fffd7534976ee8d7d76aef76 280w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general.png?w=560\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=abfa8c0c0f33cb47de69fa9ec56accc4 560w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general.png?w=840\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=fa81a4c381c8dc27ba0e604a434f5430 840w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=e4ed3f98147c4dabc36a7411a45d229b 1100w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=acaefe3db593130d0c94052ca25964ed 1650w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=0e56d34f6f195cae05c7a6bea4720dbe 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general-dark.png?fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=5d88e8271dda9d0fdccf88d4ca1db5cd`,alt:`Connection form`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`1224`,height:`1224`,\"data-path\":`images/connection-form-general-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=9d0f09dd5cf8769e89d0f159be60912b 280w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=325e641a5f59dd5af4ec0687ee5e1a41 560w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=8ac042f3a0d490ab34f072d63478b7c1 840w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=8f175a46d624580f2925c49e04199013 1100w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=3a7dd6bc6a47ce6ea401486e55190090 1650w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=854ed6cfe72583ba24c80463f9e649f8 2500w`})]}),_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Test Connection`}),` on the bar along the bottom. It turns into `,_jsx(_components.strong,{children:`Connected`}),` with a green checkmark. Now click `,_jsx(_components.strong,{children:`Save \u0026 Connect`}),` beside it.`]}),_jsxs(Frame,{caption:`Test Connection succeeded`,children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test.png?fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=d96e6842269c87551c2e6a667710ccf6`,alt:`Connection test success`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`1224`,height:`1224`,\"data-path\":`images/connection-test.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test.png?w=280\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=9084d0bee830d57c74ec73e062530c80 280w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test.png?w=560\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=1fdc4bc94ea042d0edf6f0600a9023ee 560w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test.png?w=840\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=9f572217c30ea11a12655646639b5991 840w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=4a70916286f81c928a5584a4c1788e09 1100w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=8ea8f8861ff295931ba16592917afb7b 1650w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=203f32d64d5a762698e41cbf4862252d 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test-dark.png?fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=95474c209cabbada8287c312a9181a54`,alt:`Connection test success`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`1224`,height:`1224`,\"data-path\":`images/connection-test-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=76c4193f86beeb2a4ddcb380bfa928b5 280w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=f28cfa088cd341bb5fee1c74085593f5 560w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=4c7db2126c6ee55fe49219c22e2e74f8 840w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=a4816573f94b4a88bfe0fb0e515318d8 1100w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=532129836932013df82ae4e07e9cf730 1650w, https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hpeNl6Aughc_P6IP\u0026q=85\u0026s=b99e289d5732c4a7336bed7d8612bc65 2500w`})]}),_jsx(Check,{children:_jsx(_components.p,{children:`The window switches to the main layout: databases and tables in the sidebar, the open tab in the middle, the inspector on the right.`})}),_jsxs(_components.p,{children:[`A failed attempt paints the window with the driver’s own message and a `,_jsx(_components.strong,{children:`Try Again`}),` button instead. `,_jsx(_components.a,{href:`/troubleshooting`,children:`Troubleshooting`}),` sorts refused from timed out.`]})]}),_jsxs(Step,{title:`Run a query`,children:[_jsxs(_components.p,{children:[`Click a table in the sidebar to browse it. For SQL, press `,_jsx(_components.code,{children:`Cmd+T`}),` for a query tab, type, and press `,_jsx(_components.code,{children:`Cmd+Enter`}),` to run the statement under the cursor.`]}),_jsxs(Frame,{caption:`A table tab showing the data grid`,children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app.png?fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=5bf4be3c629bd3b6bb7f874c3fda9d7f`,alt:`Main interface`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1722`,height:`1722`,\"data-path\":`images/app.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app.png?w=280\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=c55bad02ffde3fdb0ebcb9413a027782 280w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app.png?w=560\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=f273ebc579abc62aacf8e73734513b41 560w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app.png?w=840\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=099e003cb2c491aefee1d7d7ba2a7998 840w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=98d3c95b1265ce5776b11469cea7540c 1100w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=cf4b1819ff053ad10c1591647bf04e3e 1650w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=15894e46e39e255bc14eb82120d6234f 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app-dark.png?fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=451f5eed922baadb06d1b8a58bfb2672`,alt:`Main interface`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1722`,height:`1722`,\"data-path\":`images/app-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=9fb2828980d5f505a852a8b842eac98b 280w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=99685e83577a7aaba889f3fc81bed5d4 560w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=281ff636c6b050ab86ee602ba3cfc654 840w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=7caca3cd242e5180c42206bbfb557570 1100w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=f6481dc8ee124ec8964936f74fdb8ead 1650w, https://mintcdn.com/ngquct/ryMiWma7_9JTIqGV/images/app-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ryMiWma7_9JTIqGV\u0026q=85\u0026s=0f0dde459e2c6cbf926af328327ba80b 2500w`})]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`sql`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`sql`,children:_jsxs(_components.code,{language:`sql`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`SELECT`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` FROM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` users `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`LIMIT`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`what’s-next`,children:`What’s next`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/connections`,children:`Managing connections`}),`, `,_jsx(_components.a,{href:`/connections/ssh-tunneling`,children:`SSH tunneling`}),`, `,_jsx(_components.a,{href:`/features/keyboard-shortcuts`,children:`keyboard shortcuts`}),`, and `,_jsx(_components.a,{href:`/features/ai-assistant`,children:`AI features`}),`. Anything that goes wrong is worth an `,_jsx(_components.a,{href:`https://github.com/TableProApp/TablePro/issues`,children:`issue`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`For another platform, follow the `,_jsx(_components.a,{href:`/ios`,children:`iPhone and iPad guide`}),` or the `,_jsx(_components.a,{href:`/linux/install`,children:`Linux guide`}),`. `,_jsx(_components.a,{href:`/`,children:`All platforms`}),` lists availability.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Quickstart on macOS","description":"Connect to your first database and run a query on macOS","href":"/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What’s next","slug":"what’s-next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ngquct/0580ff8c60241a49/consent.js"],"dynamicCss":".mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"ngquct","siteName":"TablePro","title":"Quickstart on macOS - TablePro","contextualStarterQuestions":[{"_id":"6aefabd3395759c8d57dc166","deploymentId":"6985f6f4c6738b75506e734b","questionText":"How do I install TablePro?","status":"active","generatedBy":"contextual","path":"quickstart","createdAt":"2026-11-07T22:53:07.679Z","updatedAt":"2026-11-07T22:53:07.679Z","__v":0},{"_id":"6aefabd3395759c8d57dc167","deploymentId":"6985f6f4c6738b75506e734b","questionText":"How do I create a connection?","status":"active","generatedBy":"contextual","path":"quickstart","createdAt":"2026-11-07T22:53:07.679Z","updatedAt":"2026-11-07T22:53:07.679Z","__v":0},{"_id":"6aefabd3395759c8d57dc168","deploymentId":"6985f6f4c6738b75506e734b","questionText":"What's the sample database?","status":"active","generatedBy":"contextual","path":"quickstart","createdAt":"2026-11-07T22:53:07.679Z","updatedAt":"2026-11-07T22:53:07.679Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T22:53:03.207Z","originalFileLocation":"quickstart.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect to your first database and run a query on macOS\">\u003cmeta data-mint-head name=\"application-name\" content=\"TablePro\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Quickstart on macOS - TablePro\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect to your first database and run a query on macOS\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TablePro\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tablepro.app/quickstart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ngquct.mintlify.site/_mintlify/api/og/v2?division=Start+here\u0026amp;title=Quickstart+on+macOS\u0026amp;description=Connect+to+your+first+database+and+run+a+query+on+macOS\u0026amp;theme=05bf6c176e3d0a084220f8d3\u0026amp;signature=0db49d69625aa3957167bf105d423a96fa169bc669b8c3a13d873129f5ff36e8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Quickstart on macOS - TablePro\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect to your first database and run a query on macOS\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ngquct.mintlify.site/_mintlify/api/og/v2?division=Start+here\u0026amp;title=Quickstart+on+macOS\u0026amp;description=Connect+to+your+first+database+and+run+a+query+on+macOS\u0026amp;theme=05bf6c176e3d0a084220f8d3\u0026amp;signature=0db49d69625aa3957167bf105d423a96fa169bc669b8c3a13d873129f5ff36e8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ngquct/hOHYx5WRuqn77ewp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TablePro\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A85A00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tablepro.app/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/quickstart.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://tablepro.app/#organization\",\"name\":\"TablePro\",\"url\":\"https://tablepro.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ngquct/6U84YfHWHIioid_B/logo/light.png?fit=max\u0026auto=format\u0026n=6U84YfHWHIioid_B\u0026q=85\u0026s=e0fe9a9794d4820c6bdb38a45e5ecca8\"},\"sameAs\":[\"https://github.com/TableProApp/TablePro\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tablepro.app#website\",\"name\":\"TablePro\",\"url\":\"https://docs.tablepro.app\",\"publisher\":{\"@id\":\"https://tablepro.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tablepro.app/quickstart#webpage\",\"url\":\"https://docs.tablepro.app/quickstart\",\"name\":\"Quickstart on macOS\",\"description\":\"Connect to your first database and run a query on macOS\",\"dateModified\":\"2026-11-07T22:53:03.207Z\",\"isPartOf\":{\"@id\":\"https://docs.tablepro.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tablepro.app/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tablepro.app/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start here\",\"item\":\"https://docs.tablepro.app/installation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Quickstart on macOS\",\"item\":\"https://docs.tablepro.app/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.tablepro.app/quickstart#article\",\"headline\":\"Quickstart on macOS\",\"name\":\"Quickstart on macOS\",\"description\":\"Connect to your first database and run a query on macOS\",\"url\":\"https://docs.tablepro.app/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tablepro.app/quickstart#webpage\"},\"dateModified\":\"2026-11-07T22:53:03.207Z\",\"publisher\":{\"@id\":\"https://tablepro.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tablepro.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TablePro\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"TablePro\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/quickstart.md","siteName":"TablePro","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/TableProApp/TablePro"},{"anchor":"Download","icon":"download","href":"https://tablepro.app/download"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/hCNmUUbnD4"},{"anchor":"Telegram","icon":"telegram","href":"https://t.me/tablepro_app"}]},"tabs":[{"tab":"Overview","icon":"house","pages":[{"title":"Overview","href":""}]},{"tab":"macOS","icon":"apple","groups":[{"group":"Start here","pages":[{"title":"Install on macOS","href":"/installation"},{"title":"Beta updates on macOS","description":"Choose the Mac beta channel or return to stable releases","href":"/beta-updates"},{"title":"Quickstart on macOS","href":"/quickstart"},{"title":"Switching to TablePro","description":"Move your connections and saved queries from TablePlus, Sequel Ace, DBeaver, DataGrip, Beekeeper Studio or Navicat, what comes across, what does not, and how to get your shortcuts back","href":"/switching"},{"title":"Troubleshooting on macOS","href":"/troubleshooting"}]},{"group":"Connections","icon":"plug","pages":[{"title":"Managing Connections","href":"/connections/index"},{"title":"Connection form","href":"/connections/connection-form"},{"title":"Connection URL Reference","href":"/connections/urls"},{"title":"SSH Tunneling","href":"/connections/ssh-tunneling"},{"title":"Credential Profiles","href":"/connections/credential-profiles"},{"title":"SSH Profiles","href":"/connections/ssh-profiles"},{"title":"Remote Database Files","href":"/connections/remote-database-files"},{"title":"Cloudflare Tunnel","href":"/connections/cloudflare-tunnel"},{"title":"Cloud SQL Auth Proxy","href":"/connections/cloud-sql-proxy"},{"title":"SOCKS Proxy","href":"/connections/socks-proxy"},{"title":"Tunnel Command","href":"/connections/tunnel-command"},{"title":"AWS IAM Authentication","href":"/connections/aws-iam"},{"title":"SSL/TLS","href":"/connections/ssl"},{"title":"Connection Sharing","href":"/features/connection-sharing"},{"title":"Open Project Folder","href":"/features/project-folder-import"}]},{"group":"Databases","icon":"database","pages":[{"title":"Supported Databases","href":"/databases/index"},{"title":"Plugins","href":"/features/plugins"},{"title":"Amazon DynamoDB","href":"/databases/dynamodb"},{"title":"Amazon Redshift","href":"/databases/redshift"},{"title":"Beancount","href":"/databases/beancount"},{"title":"Cassandra / ScyllaDB","href":"/databases/cassandra"},{"title":"ClickHouse","href":"/databases/clickhouse"},{"title":"Cloudflare D1","href":"/databases/cloudflare-d1"},{"title":"Cloudflare R2 SQL","href":"/databases/cloudflare-r2-sql"},{"title":"CockroachDB","href":"/databases/cockroachdb"},{"title":"Dameng DM8","href":"/databases/dameng"},{"title":"Databend","href":"/databases/databend"},{"title":"DuckDB","href":"/databases/duckdb"},{"title":"Elasticsearch","href":"/databases/elasticsearch"},{"title":"etcd","href":"/databases/etcd"},{"title":"Firebase","href":"/databases/firebase"},{"title":"Google BigQuery","href":"/databases/bigquery"},{"title":"Google Cloud Bigtable","href":"/databases/bigtable"},{"title":"InfluxDB","href":"/databases/influxdb"},{"title":"Kafka","href":"/databases/kafka"},{"title":"KingbaseES","href":"/databases/kingbasees"},{"title":"libSQL / Turso","href":"/databases/libsql"},{"title":"MariaDB","href":"/databases/mariadb"},{"title":"Memcached","href":"/databases/memcached"},{"title":"Microsoft SQL Server","href":"/databases/mssql"},{"title":"MongoDB","href":"/databases/mongodb"},{"title":"MySQL","href":"/databases/mysql"},{"title":"Neo4j","href":"/databases/neo4j"},{"title":"OceanBase","href":"/databases/oceanbase"},{"title":"Oracle Database","href":"/databases/oracle"},{"title":"PGlite","href":"/databases/pglite"},{"title":"PostgreSQL","href":"/databases/postgresql"},{"title":"Qdrant","href":"/databases/qdrant"},{"title":"Redis","href":"/databases/redis"},{"title":"SAP HANA","href":"/databases/sap-hana"},{"title":"Snowflake","href":"/databases/snowflake"},{"title":"Google Cloud Spanner","href":"/databases/spanner"},{"title":"StarRocks","href":"/databases/starrocks"},{"title":"SQLite","href":"/databases/sqlite"},{"title":"SurrealDB","href":"/databases/surrealdb"},{"title":"Teradata","href":"/databases/teradata"},{"title":"TiDB","href":"/databases/tidb"},{"title":"Trino / Presto","href":"/databases/trino"},{"title":"Typesense","href":"/databases/typesense"},{"title":"Weaviate","href":"/databases/weaviate"}]},{"group":"Write SQL","icon":"code","pages":[{"title":"SQL Editor","href":"/features/sql-editor"},{"title":"Code Folding","href":"/features/code-folding"},{"title":"SQL Files","href":"/features/sql-files"},{"title":"Autocomplete","href":"/features/autocomplete"},{"title":"Query Parameters","href":"/features/query-parameters"},{"title":"Vim Mode","href":"/features/vim-mode"},{"title":"Emacs Mode","href":"/features/emacs-mode"},{"title":"Query History","href":"/features/query-history"},{"title":"Query Insights","href":"/features/query-insights"}]},{"group":"Browse and edit data","icon":"table","pages":[{"title":"Data Grid","href":"/features/data-grid"},{"title":"Query Results","href":"/features/query-results"},{"title":"Filtering","href":"/features/filtering"},{"title":"Search database","href":"/features/search-database"},{"title":"Change Tracking","href":"/features/change-tracking"},{"title":"Cell and Row Viewers","href":"/features/json-viewer"},{"title":"Data Files","href":"/features/data-files"}]},{"group":"Schema and server","icon":"sitemap","pages":[{"title":"Table Structure","href":"/features/table-structure"},{"title":"Procedures, Functions, and Triggers","href":"/features/routines-triggers"},{"title":"Routine Debugger","href":"/features/routine-debugger"},{"title":"Live Messages","href":"/features/live-messages"},{"title":"User-Defined Types","href":"/features/user-defined-types"},{"title":"Table Operations","href":"/features/table-operations"},{"title":"ER Diagram","href":"/features/er-diagram"},{"title":"Join Builder","href":"/features/join-builder"},{"title":"EXPLAIN Visualization","href":"/features/explain-visualization"},{"title":"Server Dashboard","href":"/features/server-dashboard"},{"title":"Table Health","href":"/features/table-health"},{"title":"Users \u0026 Roles","href":"/features/users-roles"}]},{"group":"Import and export","icon":"arrow-right-arrow-left","pages":[{"title":"Import \u0026 Export","href":"/features/import-export"},{"title":"Copy and duplicate","href":"/features/copy-objects"},{"title":"Backup \u0026 Restore","href":"/features/backup-restore"},{"title":"Compare \u0026 Sync","href":"/features/compare-sync"}]},{"group":"AI","icon":"sparkles","pages":[{"title":"AI Assistant","href":"/features/ai-assistant"},{"title":"Agent mode","href":"/features/agent-mode"},{"title":"MCP Server","href":"/features/mcp"},{"title":"Outside MCP servers","href":"/features/mcp-outside-servers"}]},{"group":"Integrations","icon":"puzzle-piece","pages":[{"title":"Integrations","sidebarTitle":"Overview","href":"/integrations/index"},{"title":"MCP Clients","href":"/integrations/mcp-clients"},{"title":"Raycast","href":"/integrations/raycast"},{"title":"Terminal","href":"/integrations/terminal"},{"title":"DDEV","href":"/integrations/ddev"},{"title":"Shortcuts","href":"/integrations/shortcuts"}]},{"group":"Around the app","icon":"window-maximize","pages":[{"title":"macOS features","href":"/features/overview"},{"title":"Connection window","href":"/features/connection-window"},{"title":"Query Tabs","href":"/features/tabs"},{"title":"Connections strip","href":"/features/workspace-rail"},{"title":"Open Quickly","href":"/features/open-quickly"},{"title":"Favorites","href":"/features/favorites"},{"title":"Keyboard Shortcuts","href":"/features/keyboard-shortcuts"}]},{"group":"Sync and licensing","icon":"arrows-rotate","pages":[{"title":"iCloud Sync","href":"/features/icloud-sync"},{"title":"Handoff","href":"/features/handoff"},{"title":"Licensing","href":"/features/licensing"},{"title":"Team Plan","href":"/features/team"}]},{"group":"Customization","pages":[{"title":"Settings","href":"/customization/settings"},{"title":"General Settings","href":"/customization/general-settings"},{"title":"Appearance","href":"/customization/appearance"},{"title":"Editor Settings","href":"/customization/editor-settings"},{"title":"Data Settings","href":"/customization/data-settings"},{"title":"Notifications","href":"/customization/notifications"}]},{"group":"Security and privacy","icon":"shield","pages":[{"title":"Privacy","href":"/security/privacy"},{"title":"Managed updates","href":"/security/managed-updates"},{"title":"Safe Mode","href":"/features/safe-mode"},{"title":"Data Masking","href":"/features/data-masking"},{"title":"Acknowledgements","href":"/features/acknowledgements"}]}]},{"tab":"iPhone and iPad","icon":"mobile","pages":[{"title":"iPhone and iPad","href":"/ios"}]},{"tab":"Linux beta","icon":"linux","pages":[{"title":"Linux beta","href":"/linux/install"}]},{"tab":"Developers","icon":"code","pages":[{"title":"Developers","href":"/developers"}]},{"tab":"Contributing","icon":"code-branch","pages":[{"title":"Contributing","href":"/development/overview"}]}]},"basePath":"","title":"Quickstart on macOS - TablePro","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BXrZabKK.js","DynamicMarkdown-CtasenyM.js","zoom-image-lightbox-C5F0mVLH.js","lightbox-handle-r17bVUz3.js"]}