Skip to content
On this page



Please back up the database before upgrading to avoid data loss caused by improper upgrading.

Panel Auto Upgrade

When a new version is available, there will be a new version prompt on the dashboard of the control panel. Click the “Upgrade” button on the upgrade page to upgrade automatically.

Command Auto Upgrade

In the root directory of the main program, use the “terminal” command line to execute the Fresns upgrade command.

php artisan fresns:upgrade

If you need to confirm the executed command during the upgrade, enter yes to continue.

Physical Upgrade

    1. If you download the new version of the installation package, all the other files except the “Extension” and “Configuration Information” of the old version will be overwritten (before overwriting, please make a copy of the old version of the project to avoid the loss of the information of the old version due to improper overwriting).
    • If you are using a local storage plugin, you should also keep the files located in the storage directory according to the plug-in documentation.
fresns/         // Main Program Root Directory
├── extensions/     // Extension Directory(plugins and themes)
├── storage/        // Storage Directory
│   └── app
│       └── public
├── .env            // Configuration File
├── fresns.json     // Fresns Config
└── install.lock    // Installation Lock File (after having this file, it is forbidden to execute the installation again)
    1. After overwriting, all plug-ins in plugins brackets in fresns.json file will be deactivated (true will be changed to false), with the remaining configuration items unchanged (after physical upgrade, the system will automatically correct to the latest version information and restore the previously enabled plug-ins).
    "name": "Fresns",
    "version": "2.0.0",
    "versionInt": 1, // Please do not modify before upgrading
    "plugins": {
        "FresnsEmail": false, // true means activate, false means deactivate
        "EasySms": false,
        "CmdWordTool": false,
        "HelperTool": false,
        "Placeholder": false

// Or remove the plugin status

    "name": "Fresns",
    "version": "2.0.0",
    "versionInt": 1, // Please do not modify before upgrading
    "plugins": {}
    1. Log in to the background (control panel) and click the “Physical Upgrade” button on the “Dashboard -> Update” page to confirm the upgrade.
    • The system will automatically perform migration and installation of plug-ins and themes.
    • Upon completion, the version information in fresns.json file will be updated and the plug-in that was enabled before will be restored.

Released under the Apache-2.0 License