75 lines
1.7 KiB
Markdown
75 lines
1.7 KiB
Markdown
# 🚀 Quick Version Update Guide
|
|
|
|
**Current Version**: `6.10.0`
|
|
|
|
---
|
|
|
|
## Fast Track (5 minutes)
|
|
|
|
### 1. Run the COMPREHENSIVE automated script
|
|
```bash
|
|
cd /opt/media-downloader
|
|
bash scripts/update-all-versions.sh 6.11.0 # Replace with your new version
|
|
```
|
|
|
|
This script updates **ALL** version references across the entire codebase automatically!
|
|
|
|
### 2. Update changelogs (manual)
|
|
- Edit `data/changelog.json` - add entry at TOP
|
|
- Edit `docs/CHANGELOG.md` - add section at TOP
|
|
|
|
### 3. Finalize
|
|
```bash
|
|
# Services restart automatically (dev server running)
|
|
# Or manually restart:
|
|
sudo systemctl restart media-downloader-api media-downloader.service
|
|
|
|
# Create version backup
|
|
bash scripts/create-version-backup.sh
|
|
```
|
|
|
|
### 4. Verify
|
|
- Open browser: Check login page shows correct version
|
|
- Check Dashboard loads correctly
|
|
- Check Configuration page shows correct version
|
|
- Verify Health page loads
|
|
|
|
---
|
|
|
|
## Files Updated by Script (Automatic)
|
|
|
|
✅ `/opt/media-downloader/VERSION`
|
|
✅ `/opt/media-downloader/README.md` (header + directory structure comment)
|
|
✅ `web/frontend/src/pages/Login.tsx`
|
|
✅ `web/frontend/src/App.tsx` (2 locations)
|
|
✅ `web/frontend/src/pages/Configuration.tsx` (multiple locations)
|
|
✅ `web/frontend/package.json`
|
|
|
|
---
|
|
|
|
## Manual Updates Required
|
|
|
|
❌ `data/changelog.json` - Add new version entry
|
|
❌ `CHANGELOG.md` - Add new version section
|
|
|
|
---
|
|
|
|
## Full Documentation
|
|
|
|
For complete checklist and troubleshooting:
|
|
📖 **[docs/VERSION_UPDATE_CHECKLIST.md](docs/VERSION_UPDATE_CHECKLIST.md)**
|
|
|
|
---
|
|
|
|
## Version Number Format
|
|
|
|
Follow [Semantic Versioning](https://semver.org/): `MAJOR.MINOR.PATCH`
|
|
|
|
- **6.x.0** - Major features, breaking changes
|
|
- **6.4.x** - New features, backward-compatible
|
|
- **6.4.2** - Bug fixes, patches
|
|
|
|
---
|
|
|
|
**Last Updated**: 2025-10-31
|