REV. 5.0 — Masonite 5 is here Read the changelog
MasoniteFRAMEWORK
GitHub Get started
Docs Features Changelog GitHub Get started
SHEET 05 masonite.dev

Changelog

Releases, migrations and project news.

In memoriam

In memory of Joseph “Joe” Mancuso

Masonite was created by Joseph “Joe” Mancuso, who passed away in November 2025. Joe built Masonite from the ground up and gave years of work, care and enthusiasm to the framework and its community — everything here exists because of him. The project now continues in his memory, carrying forward the developer-first spirit he gave it. Thank you for everything, Joe.

NEWS Project

Masonite has a new home

Following Joe's passing, the community has taken stewardship of the framework and moved active development to the new masonitedev organization on GitHub. The repository now lives at github.com/masonitedev/masonite and the docs at docs.masonite.dev. The PyPI package was renamed from masonite to masonite-framework.

The original repository and the old masonite package (4.x and earlier) are now deprecated and will no longer receive updates or security fixes — all future development happens under masonitedev.

UPDATE YOUR GIT REMOTE

BASH
$ git remote set-url origin https://github.com/masonitedev/masonite.git
REV. 5.0 Release

Masonite 5.0 latest 5.0.1

  • New home & packageMoved to the masonitedev GitHub org; install with pip install masonite-framework.
  • New logging systemA full logging stack with terminal, single, daily, stack, syslog and slack drivers, configured in config/logging.py and exposed via the Log facade. Unhandled exceptions are now logged automatically with their full traceback.
  • Updated runtimePython 3.10–3.13 is now required (3.8 and 3.9 were dropped at end-of-life).
  • Updated core dependenciesMasonite ORM 3.x and Pendulum 3.x are now required. The ORM is published as masonite-framework-orm (replacing masonite-orm); imports are unchanged (from masoniteorm...).
GUIDE Migration

Upgrading from 4.x to 5.x

  1. Swap the package:
    BASH
    $ pip uninstall masonite
$ pip install "masonite-framework>=5,<6"
  2. Imports are unchanged — keep using import masonite / from masonite import ...; the project and craft commands work the same way.
  3. Make sure you're on Python 3.10–3.13.
  4. Pendulum 3 parses dates more strictly — review your date parsing. In tests, replace pendulum.set_test_now() with pendulum.travel_to() or the built-in self.fakeTime() helper.
  5. Update your git remote (see command above).

Need the full picture? Read the full upgrade guide →