---
title: "What is a local catalog?"
description: "A local catalog is the on-disk database, caches, and media home where tables live when you run the engine on your own machine."
url: "https://www.pixeltable.com/learn/what-is-a-local-catalog"
updated: "2026-09-29"
vertical: "Storage"
doc: "https://docs.pixeltable.com/overview/quick-start"
---

# What is a local catalog?

A local catalog is the on-disk database, caches, and media home where tables live when you run the engine on your own machine.

Updated: 2026-09-29


## On this page

- [How it works](https://www.pixeltable.com/learn/what-is-a-local-catalog#how-it-works)
- [What it is not](https://www.pixeltable.com/learn/what-is-a-local-catalog#what-it-is-not)
- [Comparison](https://www.pixeltable.com/learn/what-is-a-local-catalog#comparison)
- [Where Pixeltable fits](https://www.pixeltable.com/learn/what-is-a-local-catalog#where-pixeltable-fits)
- [Questions](https://www.pixeltable.com/learn/what-is-a-local-catalog#questions)

## How it works {#how-it-works}


- Install the package and apply a schema.
- Tables go to pgdata and generated media to media/ under the catalog home; inserted files stay where they are.
- The same schema can later apply to a hosted database.

## What it is not {#what-it-is-not}

It is not a hosted database, and it is not a Docker volume you never version.

## local catalog: this, and the thing it is confused with {#comparison}

|  | This | Not this |
| --- | --- | --- |
| Where | Your disk | A cloud account |
| Account | None required | Required to host |
| Schema | The same file | A rewrite |

## Where Pixeltable fits {#where-pixeltable-fits}

Pixeltable’s local catalog is what pip install gives you. PIXELTABLE_HOME is the directory that catalog uses.

## Questions {#questions}

### How does local catalog work? {#faq-1}

Install the package and apply a schema. Tables go to pgdata and generated media to media/ under the catalog home; inserted files stay where they are. The same schema can later apply to a hosted database.

### What is local catalog often confused with? {#faq-2}

It is not a hosted database, and it is not a Docker volume you never version.

## In the blog

- [Run Pixeltable in Docker Without Losing Your Catalog](https://www.pixeltable.com/blog/pixeltable-docker-volumes-pixeltable-home)
- [Pixeltable Starter Kit: From Clone to Production AI App in Minutes](https://www.pixeltable.com/blog/pixeltable-starter-kit-launch)
- [Powering Multimodal LLMs: Pixeltable MCP Servers for Rich Data Context](https://www.pixeltable.com/blog/pixeltable-mcp-servers)
- [Databricks alternatives for multimodal AI apps (and when to keep Databricks)](https://www.pixeltable.com/blog/pixeltable-databricks-alternative)
- [Research, code and images on the GPU you already own, as one Pixeltable app](https://www.pixeltable.com/blog/self-hosted-ai-research-code-images-local-gpu-pixeltable)
- [vLLM: High-Throughput Local LLM Inference in Pixeltable](https://www.pixeltable.com/blog/vllm-high-throughput-local-inference-pixeltable)

## Related

- [Documentation](https://docs.pixeltable.com/overview/quick-start)
- [Run Pixeltable in Docker Without Losing Your Catalog](https://www.pixeltable.com/blog/pixeltable-docker-volumes-pixeltable-home)
- [Understanding Pixeltable Storage: The Four-Layer Architecture That Powers Multimodal AI](https://www.pixeltable.com/blog/understanding-pixeltable-storage-architecture)
- [Why the Local-Cloud Loop Matters](https://www.pixeltable.com/blog/why-local-cloud-loop-matters)