Mathesar Documentation

Help us get our beta out sooner – send us feedback!

You’re looking at the documentation for our ✨ new test build ✨, see release notes here.

For a timely and stable beta release, we need feedback from as many users as possible about how this new version of Mathesar is working for you. Let us know on this GitHub discussion or drop us a line at hello@mathesar.org.

Welcome!

Mathesar is a self-hostable open source project that provides a spreadsheet-like interface to a PostgreSQL database. Our web-based interface helps you and your collaborators set up data models, edit data, and build custom reports — no technical skills needed. You can create a new PostgreSQL database while setting up Mathesar or use our UI to interact with an existing database (or do both).

Try Mathesar

Live demo

See our live demo site to try Mathesar without installing anything.

Try locally

This is a quick way to play with Mathesar locally, but is not appropriate for saving data that you care about or setting up a long-term installation.

1. With Docker installed, run:

   docker run -it --name mathesar -p 8000:8000 mathesar/mathesar-testing:latest
   

2. Visit http://localhost:8000/ to set up an admin user account and create a database connection.

   Tips when trying Mathesar locally

   • To open a psql shell within the container, run:

     docker exec -it mathesar sudo -u postgres psql
     

   • To stop Mathesar, press Ctrl+C in the shell where it is running.

   • To start again, run docker start mathesar.

   • To remove the Docker container, run docker rm mathesar .

     ⚠️ This will also delete the data that you’ve saved within Mathesar!

Install Mathesar

You can self-host Mathesar by following one of the guides below:

• Install using Docker compose — a production setup with separate reverse-proxy and database containers.
• Install from scratch — an advanced setup that doesn’t rely on Docker.

More installation methods coming soon

We’re working on supporting additional installation methods, and we’d appreciate feedback on which ones to prioritize. Please comment on this issue if you have thoughts.

Use Mathesar

See our Using Mathesar section for documentation on Mathesar’s features.

Contribute to Mathesar

As an open source project, we actively encourage contribution! Get started by reading our Contributor Guide.

Donate

We’re a non-profit and your donations help sustain our core team. You can donate via GitHub or Open Collective.