PHPackages librepim/librepim-dev - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. librepim/librepim-dev ActiveLibrary[Utility & Helpers](/categories/utility) librepim/librepim-dev ===================== LibrePIM - Community-Maintained Fork of Akeneo PIM Community Edition v8.1.0(2w ago)141852[1 PRs](https://github.com/libre-pim/librepim-dev/pulls)1OSL-3.0PHPPHP ^8.3CI passing Since Dec 30Pushed 2w agoCompare [ Source](https://github.com/libre-pim/librepim-dev)[ Packagist](https://packagist.org/packages/librepim/librepim-dev)[ Docs](https://github.com/libre-pim/librepim-dev)[ RSS](/packages/librepim-librepim-dev/feed)WikiDiscussions master Synced today READMEChangelog (3)Dependencies (209)Versions (5)Used By (1) **Librepim – Community-Driven LTS Fork of Akeneo PIM Community Edition** ======================================================================== [](#librepim--community-driven-lts-fork-of-akeneo-pim-community-edition) > ⚠️ **This is a community fork, not an official Akeneo project.** Librepim is maintained independently to provide long-term support for Akeneo PIM Community Edition users. For details, see [CONTRIBUTORS.md](./CONTRIBUTORS.md). **Librepim** is an open-source, community-maintained fork of the **Akeneo PIM Community Edition**. Its goal is to provide **Long-Term Support (LTS)**, continued improvements, security fixes, and compatibility updates for teams that rely on the community version of Akeneo for product information management. Librepim is built on the foundation of Akeneo CE, extending its life through community contributions and modern package updates. --- πŸš€ Key Highlights ---------------- [](#-key-highlights) ### **πŸ”’ Long-Term Support (LTS)** [](#-long-term-support-lts) Continuous improvements, bug fixes, dependency upgrades, and security patches. ### **πŸ”§ Compatible Migration** [](#-compatible-migration) Users of Akeneo PIM CE can migrate to Librepim with minimal changes. ### **🀝 Community-Driven** [](#-community-driven) Contributions are welcomeβ€”from fixes and feature enhancements to documentation improvements. ### **⚑ Stability & Performance** [](#-stability--performance) Focused on maintaining a stable and secure PIM experience for real-world workloads. --- πŸ“¦ Installation -------------- [](#-installation) Librepim follows the same installation workflow as the Akeneo PIM Community Edition, with only a few configuration-level differences. Refer to the official installation steps here: πŸ‘‰ **Installation Guide (Akeneo CE compatible)**[https://docs.akeneo.com/master/install\_pim/index.html](https://docs.akeneo.com/master/install_pim/index.html) To build the development Docker image: ``` docker build --target dev -t webkul/librepim-php-dev:master . ``` --- πŸ” Search Engine (Elasticsearch or OpenSearch) --------------------------------------------- [](#-search-engine-elasticsearch-or-opensearch) LibrePIM runs on **Elasticsearch 8** by default and also supports **OpenSearch 2.x** as an alternative. The choice is made by the `SEARCH_ENGINE` environment variable; the rest of the codebase is engine-agnostic. ### Selecting the engine [](#selecting-the-engine) In your environment configuration: ``` # Default. Native Elasticsearch 8 client. SEARCH_ENGINE=elasticsearch APP_INDEX_HOSTS= # Or opt into OpenSearch. # SEARCH_ENGINE=opensearch # APP_INDEX_HOSTS= ``` `SEARCH_ENGINE` and `APP_INDEX_HOSTS` must point at the same engine. If `SEARCH_ENGINE` is unset or empty, Elasticsearch is used. After switching engines, clear the Symfony cache and re-index: ``` rm -rf var/cache/* php bin/console akeneo:elasticsearch:reset-indexes --env=prod php bin/console pim:product:index --all --env=prod php bin/console pim:product-model:index --all --env=prod ``` ### How it works [](#how-it-works) When `SEARCH_ENGINE=opensearch`, the `akeneo_elasticsearch.client_builder`service returns an `OpenSearchClientBuilderAdapter` instead of the native `Elastic\Elasticsearch\ClientBuilder`. The adapter wraps the real `OpenSearch\Client` so calls like `->index()`, `->search()`, and `->indices()->putMapping()` route to OpenSearch, and translates `OpenSearch\Common\Exceptions\OpenSearchException` (and its subclasses) into `Elastic\Elasticsearch\Exception\ClientResponseException` or `ServerResponseException`, preserving the HTTP status on the attached PSR-7 response. Existing `catch (ElasticsearchException $e)` blocks across LibrePIM keep working unchanged. The adapter layer lives at `src/Akeneo/Tool/Bundle/ElasticsearchBundle/SearchEngine/` and is the only place that references both vendor SDKs. The Elasticsearch path is unchanged β€” when `SEARCH_ENGINE` is `elasticsearch` (or unset), `SearchEngineClientBuilderFactory` returns the native `Elastic\Elasticsearch\ClientBuilder` and the rest of the codebase runs against Elasticsearch exactly as before. ### Spec coverage [](#spec-coverage) The OSβ†’ES exception translator is unit-tested at `src/Akeneo/Tool/Bundle/ElasticsearchBundle/spec/SearchEngine/SearchEngineExceptionTranslatorSpec.php`. ``` vendor/bin/phpspec run src/Akeneo/Tool/Bundle/ElasticsearchBundle/spec ``` ### Pinning notes [](#pinning-notes) `opensearch-project/opensearch-php` is pinned at `~2.3.1`. Newer 2.x releases require `psr/http-message ^2.0`, which conflicts with other LibrePIM dependencies. ### Common pitfalls [](#common-pitfalls) SymptomCauseFix`ProductCheckException: server is not Elasticsearch`The Elasticsearch client is talking to an OpenSearch serverSet `SEARCH_ENGINE=opensearch`, then `rm -rf var/cache/*``alias missing` (404) on a fresh OpenSearch instanceFirst-run reset before any indexes existRe-run `akeneo:elasticsearch:reset-indexes` β€” it is idempotent and will create the missing aliasesUI shows zero products after switchingThe search index for the new engine is empty (MySQL data is shared, the search index is per-engine)Run `pim:product:index --all` and `pim:product-model:index --all``cache:clear` failsThe compiled cache references stale class names`rm -rf var/cache/*` instead of `cache:clear``composer install` drops `opensearch-php`The lock file may not track it`composer require opensearch-project/opensearch-php:~2.3.1`--- πŸ”„ Upgrading ----------- [](#-upgrading) Librepim follows Akeneo CE’s upgrade flow, making transitions simple and predictable. πŸ‘‰ **Upgrade Guide (Akeneo process compatible)**[https://docs.akeneo.com/master/migrate\_pim/index.html](https://docs.akeneo.com/master/migrate_pim/index.html) --- πŸ§ͺ Testing --------- [](#-testing) Testing workflows are the same as Akeneo CE. You can follow their testing documentation to run unit, integration, and end-to-end tests. πŸ‘‰ **Testing Guide**[https://github.com/akeneo/pim-community-dev/blob/master/internal\_doc/tests/running\_the\_tests.md](https://github.com/akeneo/pim-community-dev/blob/master/internal_doc/tests/running_the_tests.md) --- 🀝 Contributing to Librepim -------------------------- [](#-contributing-to-librepim) We encourage the community to participate and help improve the project. Please read our **Contributing Guidelines** before submitting a pull request: πŸ‘‰ [CONTRIBUTING.md](./CONTRIBUTING.md) Contributions may include: - Bug fixes - Documentation improvements - Dependency updates - Feature enhancements - Security improvements A respectful and collaborative environment is expected from everyone involved. --- πŸ“„ License --------- [](#-license) Librepim is distributed under the **Open Software License (OSL 3.0)**, the same license used by Akeneo PIM CE. πŸ‘‰ [LICENSE.txt](./LICENSE.txt) --- 🎯 Why Librepim? --------------- [](#-why-librepim) - **Continued Support:** Ongoing maintenance for users of Akeneo CE - **Security First:** Regular patches and dependency updates - **Predictable Migration:** Drop-in replacement for Akeneo CE - **Community Ownership:** Built and improved by open-source contributors - **Open & Transparent:** 100% free and community-governed --- ℹ️ About the Project -------------------- [](#ℹ️-about-the-project) **Librepim** aims to ensure a long-term, stable future for the Akeneo Community Edition ecosystem by: - Providing LTS - Ensuring modern PHP, Symfony, and package compatibility - Maintaining open-source availability for businesses and developers - Encouraging community collaboration and contributions Whether you're using Akeneo CE for small catalogs or managing large-scale product data, Librepim helps you continue with confidence. --- πŸ”— Useful Links -------------- [](#-useful-links) - **Akeneo PIM Documentation** - **Librepim Repository** - **Contributing Guide**./CONTRIBUTING.md - **Issue Tracker** --- πŸ’¬ Final Note ------------ [](#-final-note) Librepim is built for the community and maintained by the community. If you're looking for a stable, secure, and continuously maintained version of Akeneo CE, Librepim is the ideal choice. Join us, contribute, and help keep the open-source PIM ecosystem strong. ### Health Score 50 β€” FairBetter than 95% of packages Maintenance96 Actively maintained with recent releases Popularity22 Limited adoption so far Community23 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor6 6 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~84 days Total 3 Last Release 19d ago PHP version history (2 changes)v8.0.0PHP ^8.2 || ^8.3 v8.0.1PHP ^8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/282263096?v=4)[navneetbhardwaj](/maintainers/navneetbhardwaj)[@NavneetBhardwaj](https://github.com/NavneetBhardwaj) --- Top Contributors [![nidup](https://avatars.githubusercontent.com/u/2104359?v=4)](https://github.com/nidup "nidup (7285 commits)")[![fitn](https://avatars.githubusercontent.com/u/2131005?v=4)](https://github.com/fitn "fitn (5241 commits)")[![pierallard](https://avatars.githubusercontent.com/u/1590933?v=4)](https://github.com/pierallard "pierallard (3844 commits)")[![jjanvier](https://avatars.githubusercontent.com/u/3691804?v=4)](https://github.com/jjanvier "jjanvier (2617 commits)")[![gquemener](https://avatars.githubusercontent.com/u/668604?v=4)](https://github.com/gquemener "gquemener (1911 commits)")[![juliensnz](https://avatars.githubusercontent.com/u/1117272?v=4)](https://github.com/juliensnz "juliensnz (1896 commits)")[![BitOne](https://avatars.githubusercontent.com/u/2151567?v=4)](https://github.com/BitOne "BitOne (1460 commits)")[![jmleroux](https://avatars.githubusercontent.com/u/1516770?v=4)](https://github.com/jmleroux "jmleroux (1395 commits)")[![nelson-akeneo](https://avatars.githubusercontent.com/u/38349096?v=4)](https://github.com/nelson-akeneo "nelson-akeneo (1340 commits)")[![arnolanglade](https://avatars.githubusercontent.com/u/3585922?v=4)](https://github.com/arnolanglade "arnolanglade (1268 commits)")[![tseho](https://avatars.githubusercontent.com/u/1421130?v=4)](https://github.com/tseho "tseho (1206 commits)")[![StevenVAIDIE](https://avatars.githubusercontent.com/u/7239572?v=4)](https://github.com/StevenVAIDIE "StevenVAIDIE (1149 commits)")[![damien-carcel](https://avatars.githubusercontent.com/u/5039018?v=4)](https://github.com/damien-carcel "damien-carcel (1129 commits)")[![ahocquard](https://avatars.githubusercontent.com/u/1942439?v=4)](https://github.com/ahocquard "ahocquard (1081 commits)")[![mmetayer](https://avatars.githubusercontent.com/u/5301298?v=4)](https://github.com/mmetayer "mmetayer (967 commits)")[![pchasle](https://avatars.githubusercontent.com/u/1671213?v=4)](https://github.com/pchasle "pchasle (899 commits)")[![phaseinducer](https://avatars.githubusercontent.com/u/659491?v=4)](https://github.com/phaseinducer "phaseinducer (840 commits)")[![micheltag](https://avatars.githubusercontent.com/u/28758659?v=4)](https://github.com/micheltag "micheltag (769 commits)")[![RiffVentura](https://avatars.githubusercontent.com/u/7101819?v=4)](https://github.com/RiffVentura "RiffVentura (701 commits)")[![SamirBoulil](https://avatars.githubusercontent.com/u/1826473?v=4)](https://github.com/SamirBoulil "SamirBoulil (697 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm, Rector Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/librepim-librepim-dev/health.svg) ``` [![Health](https://phpackages.com/badges/librepim-librepim-dev/health.svg)](https://phpackages.com/packages/librepim-librepim-dev) ``` ### Alternatives [oro/platform Business Application Platform (BAP) 645143.5k115](/packages/oro-platform)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 585.6M577](/packages/shopware-core)[open-dxp/opendxp Content & Product Management Framework (CMS/PIM) 9421.6k61](/packages/open-dxp-opendxp)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.5k5.9M737](/packages/sylius-sylius)[chameleon-system/chameleon-base The Chameleon System core. 1028.6k5](/packages/chameleon-system-chameleon-base)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.1k17.8k](/packages/prestashop-prestashop) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)