Upgrading from ElmapiCMS v2
Important Notice
ElmapiCMS v3 is a complete rewrite with a new architecture, database structure, and API design. Due to these fundamental changes, direct upgrading from v2 to v3 is not supported.
What Changed in v3
ElmapiCMS v3 represents a major evolution with significant improvements:
New Architecture
- Laravel 12 framework (up from Laravel 9)
- React + TypeScript frontend (replacing Vue.js)
- Inertia.js for seamless SPA experience
Database Structure
- Completely redesigned database schema
- New relationships between projects, collections, and content
- Improved asset management with metadata extraction
API Changes
- RESTful API with new endpoints and filtering capabilities
Migration Options
Since direct upgrading isn't possible, here are your options:
Option 1: Fresh Installation (Recommended)
- Install ElmapiCMS v3 in a new environment
- Recreate your content structure using the new collection system
- Migrate content manually or via API
- Update your frontend applications to use the new API
Option 2: Parallel Installation
- Keep v2 running for existing applications
- Install v3 alongside for new projects
- Gradually migrate projects as needed
- Use the new API for future development
Option 3: Content Export/Import
- Export your v2 content via API or database
- Transform the data to match v3's structure
- Import into v3 using the new API endpoints
- Update your applications to use v3
Legacy v2 Support
ElmapiCMS v2 will continue to work, but it won't receive new features or updates. We recommend planning your migration to v3 to take advantage of the improved architecture and new capabilities. Thank you for your understanding and support.