Musare/.wiki/Upgrading.md

Upgrading

Musare upgrade process.

To install a new instance please see Installation.

Docker

Instructions

1. Make a backup! ./musare.sh backup
2. Execute ./musare.sh update. If an update requires any configuration changes or database migrations, you will be notified.
   • To update configuration compare example configs against your own and add/update/remove any properties as needed. For more information on properties see Configuration. Frontend and backend configuration updates always update the configVersion property.
     • Backend, compare backend/config/template.json against backend/config/default.json.
     • Frontend, compare frontend/dist/config/template.json against frontend/dist/config/default.json.
     • Environment, compare .env.example against .env.
   • To migrate database;
     • ./musare.sh stop backend
     • Set migration to true in backend/config/default.json
     • ./musare.sh start backend.
     • Follow backend logs and await migration completion notice ./musare.sh attach backend.
     • ./musare.sh stop backend
     • Set migration to false in backend/config/default.json
     • ./musare.sh start backend.

---

Non-Docker

Instructions

1. Make a backup!
2. Stop all services
3. git pull
4. cd frontend && npm install
5. cd ../backend && npm install
6. Compare example configs against your own and add/update/remove any properties as needed. For more information on properties see Configuration. Frontend and backend configuration updates always update the configVersion property.
   • Backend, compare backend/config/template.json against backend/config/default.json.
   • Frontend, compare frontend/dist/config/template.json against frontend/dist/config/default.json.
7. Start MongoDB and Redis services.
8. Run database migration;
   • Set migration to true in backend/config/default.json
   • Start backend service.
   • Follow backend logs and await migration completion notice.
   • Stop backend service.
   • Set migration to false in backend/config/default.json
9. Start backend and frontend services.