PHPackages                             userfrosting/upgrade - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. userfrosting/upgrade

ActiveUserfrosting-sprinkle[Utility & Helpers](/categories/utility)

userfrosting/upgrade
====================

Upgrade your database to the latest version of UserFrosting from previous versions of UserFrosting, and other frameworks.

v4.1.3(8y ago)1701MITPHPPHP >=5.6

Since Nov 26Pushed 8y ago5 watchersCompare

[ Source](https://github.com/userfrosting/upgrade)[ Packagist](https://packagist.org/packages/userfrosting/upgrade)[ Docs](https://github.com/userfrosting/upgrade)[ RSS](/packages/userfrosting-upgrade/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (4)DependenciesVersions (5)Used By (0)

Upgrade Sprinkle (UserFrosting 4.1)
===================================

[](#upgrade-sprinkle-userfrosting-41)

Upgrade your database to UserFrosting 4 from previous versions of UserFrosting, and other frameworks.

Usage
-----

[](#usage)

This Sprinkle sets up a fresh installation of UF4 with a pre-existing UF 3.1 database. It will attempt to migrate your users, groups, event log, and custom permissions (`authorize_group`) to UF4 entities.

### Step 1

[](#step-1)

MAKE A COPY OF YOUR CURRENT DATABASE. This tool does not drop any tables, but it is best to err on the cautious side.

### Step 2

[](#step-2)

Clone the UF4 repo and run `composer install`, as per the documentation. Manually copy `app/sprinkles.example.json` to `app/sprinkles.json`.

### Step 3

[](#step-3)

Edit UserFrosting `app/sprinkles.json` and add the following to the `require` list : `"userfrosting/upgrade": "~4.1.0"`. Also add `upgrade` to the `base` list. For example:

```
{
    "require": {
        "userfrosting/upgrade": "~4.1.0"
    },
    "base": [
        "core",
        "account",
        "admin",
        "upgrade"
    ]
}

```

### Step 4 - Update Composer

[](#step-4---update-composer)

Run `composer update` from the root project directory.

### Step 5

[](#step-5)

Run `php bakery upgrade` from the root project directory. It will prompt you for the credentials for your database - use the credentials for the database you wish to upgrade.

### Step 6

[](#step-6)

Begin migrating your code over to UF 4.1.

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 64.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

4

Last Release

3133d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5004534?v=4)[Alex Weissman](/maintainers/alexweissman)[@alexweissman](https://github.com/alexweissman)

---

Top Contributors

[![alexweissman](https://avatars.githubusercontent.com/u/5004534?v=4)](https://github.com/alexweissman "alexweissman (11 commits)")[![Netrilix](https://avatars.githubusercontent.com/u/12954013?v=4)](https://github.com/Netrilix "Netrilix (6 commits)")

---

Tags

userfrostinguserfrosting-tooluserfrostingphp user management

### Embed Badge

![Health badge](/badges/userfrosting-upgrade/health.svg)

```
[![Health](https://phpackages.com/badges/userfrosting-upgrade/health.svg)](https://phpackages.com/packages/userfrosting-upgrade)
```

###  Alternatives

[userfrosting/userfrosting

A secure, modern user management system for PHP.

1.7k11.5k](/packages/userfrosting-userfrosting)[lcharette/uf_formgenerator

Form generator for UserFrosting V5

178.7k5](/packages/lcharette-uf-formgenerator)[jp3cki/gimei

random Japanese name and address generator

107.8k](/packages/jp3cki-gimei)[pressbooks/pressbooks-aldine

Aldine is the default theme for the home page of Pressbooks networks. It is named for the Aldine Press, founded by Aldus Manutius in 1494, who is regarded by many as the world’s first publisher.

114.5k](/packages/pressbooks-pressbooks-aldine)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)