# Upgrade Guide

# Upgrade Steps

To upgrade your current version to the latest version of Bagisto, follow these steps:

  1. Download the latest version of Bagisto from one of the following links:

  2. Extract the downloaded Bagisto zip file to the desired deployment location.

  3. Open the terminal and navigate to the root folder of the extracted Bagisto folder.

  4. Run the following command in the terminal:

    composer create-project

    This command will install the necessary dependencies for the latest version of Bagisto.

  5. Open the .env file in your project's root folder. Provide the database credentials of your old project, which you want to upgrade using Bagisto.

  6. Run one of the following commands to cache the new changes:

    php artisan optimize

# -- OR --

php artisan config:cache

    These commands will cache the configuration files and optimize the project.

  7. Now, your project is ready to run the migration command. Execute the following command in the terminal:

    php artisan migrate

    WARNING

    Be cautious when using the seeder command as it may reset settings and categories. Add default settings manually if necessary.

  8. Create a symbolic link to link public assets to the storage folder by running the following command:

    php artisan storage:link

  9. Copy the contents of the previous version's folder (e.g., old-project/storage/app/public) to the corresponding folder in the latest version (e.g., new-project/storage/app/public).

    TIP

    If your existing project depends on local storage, has changed paths, or requires previous logs, ensure to include those as well.

  10. Congratulations! Your project is now upgraded to the latest version of Bagisto. However, keep in mind that if you have made significant customizations, ensure compatibility with the latest version.

# New Changes

We are excited to introduce the latest stable version of Bagisto, featuring numerous enhancements and improvements. Below are the key changes implemented from the master version to the upcoming release.

For a detailed list of changes, please visit the Bagisto CHANGELOG.md on GitHub (opens new window).

To ensure a smooth transition to this new version, we have prepared a comprehensive upgrade guide. You can find the full upgrade instructions here: Bagisto UPGRADE.md on GitHub (opens new window).

← Contribution Guide →