Skip to content

Mathesar 0.10.1

Summary

This is a minor hotfix release for Mathesar 0.10.0. It corrects version metadata that was still reporting 0.9.0 in some places. This affected both Mathesar’s reported version and versioned links in the documentation and release assets, including direct-install and Docker Compose downloads.

Related work: #5258, #5260

Upgrading to 0.10.1

PostgreSQL 13 and Python 3.9 no longer supported

Mathesar 0.8.0 ended official support for PostgreSQL 13 and Python 3.9. Please upgrade to PostgreSQL 14+ and Python 3.10+ before upgrading to Mathesar 0.10.1.

For installations using Docker Compose

If you have a Docker compose installation, run the command below:

docker compose -f /etc/mathesar/docker-compose.yml up --pull always -d

Your installation directory may be different

You may need to change /etc/mathesar/ in the command above if you chose to install Mathesar to a different directory.

For direct installations of Mathesar on Linux, macOS, or WSL

Mathesar provides an install script that automates both fresh installs and upgrades for standalone (non-Docker) installations.

Follow the steps below to upgrade Mathesar:

  1. Enter your installation directory into the box below and press Enter to personalize this guide:

    • Do not include a trailing slash.
    • Do not use any variables like $HOME.

  2. Go to your Mathesar installation directory.

    cd xMATHESAR_INSTALL_DIRx

    Note

    Your installation directory may be different from above if you used a different directory when installing Mathesar.

  3. Download and run the install script for 0.10.1 

    curl -sSfL https://github.com/mathesar-foundation/mathesar/releases/download/0.10.1/install.sh -o install.sh
chmod +x install.sh

./install.sh .

  4. Replace your gunicorn systemd service with a Mathesar systemd service

    1. Disable and stop the existing gunicorn service 

      systemctl disable gunicorn.service
systemctl stop gunicorn.service

    2. Follow the steps in Run Mathesar as a systemd service from the installation guide

    3. Remove the gunicorn service file 

      sudo rm /lib/systemd/system/gunicorn.service

  5. Update your Caddyfile

    1. Use the configuration shown in Install and configure Caddy in the installation guide, and update your Caddyfile accordingly

    2. Ensure that your domains are specified directly in the first line of the Caddyfile

    3. Restart your Caddy service 

      systemctl restart caddy.service

Tip

If you’re running Mathesar only on localhost and do not want it to run as a service, you could:

  1. Remove the gunicorn and caddy services
  2. Start Mathesar manually with: 
    mathesar run