Update upating_unit3d_version.md

This commit is contained in:
RKeaves 2025-05-04 10:34:36 -05:00
parent 4913faf5e1
commit cfe78b0e78
1 changed files with 24 additions and 20 deletions

View File

@ -6,38 +6,42 @@ Update UNIT3D to the latest version by reviewing the release notes and following
UNIT3D offers built-in backups. Refer to the [Backups documentation](docs/backups.md) for usage.
> **Important:** Ensure there is a complete backup before proceeding.
> [!IMPORTANT]
> Ensure there is a complete backup before proceeding.
## 2. Enter Maintenance Mode:
```sh
```bash
cd /var/www/html
php artisan down
```
## 3. Update UNIT3D:
> **Tip:** Before running the update, review the new releases minimum requirements to ensure the environment meets them.
> [!NOTE]
> Before running the update, review the new releases minimum requirements to ensure the environment meets them.
1. **Proceed to update:**
The updater will fetch the latest commits from the upstream repository and stage them for installation.
```sh
```bash
cd /var/www/html
php artisan git:update
```
There will be a prompt to confirm each step; choose `yes` to overwrite with the new version.
```sh
```bash
Start the update process (yes/no) [yes]:
> yes
```
2. **Accept upstream files:**
When prompted for each changed file, type `yes` to overwrite the local copy or press Enter to accept the default shown in brackets.
```sh
When prompted for each changed file, type `yes` to overwrite the local copy or press `Enter` to accept the default shown in brackets.
```bash
Update config/unit3d.php (yes/no) [yes]:
> yes
@ -45,23 +49,23 @@ php artisan down
[============================] (Done!)
```
3. **Run new migrations:**
3. **Run new migrations:**
```sh
```bash
Run new migrations (php artisan migrate) (yes/no) [yes]:
> yes
```
4. **Install new packages:**
4. **Install new packages:**
```sh
```bash
Install new packages (composer install) (yes/no) [yes]:
> yes
```
5. **Compile assets:**
5. **Compile assets:**
```sh
```bash
Compile assets (bun run build) (yes/no) [yes]:
> yes
```
@ -72,19 +76,19 @@ The following commands are **optional** and should be run only as needed to reso
- **Finish any migrations not completed:**
```sh
```bash
sudo php artisan migrate
```
- **Reinstall dependencies:**
```sh
```bash
composer install --prefer-dist --no-dev -o
```
- **Clear caches:**
```sh
```bash
sudo php artisan cache:clear && \
sudo php artisan queue:clear && \
sudo php artisan auto:email-blacklist-update && \
@ -94,13 +98,13 @@ sudo php artisan set:all_cache
- **Rebuild static assets:**
```sh
```bash
sudo bun install && sudo bun run build
```
- **Restart services:**
```sh
```bash
sudo systemctl restart php8.4-fpm && \
sudo php artisan queue:restart && \
sudo php artisan up
@ -108,8 +112,8 @@ sudo php artisan up
- **If running external UNIT3D-Announce, restart the supervisor services:**
```sh
```bash
sudo supervisorctl reread && \
sudo supervisorctl update && \
sudo supervisorctl reload
```
```