Welcome to the official repository profile for OCS Inventory (Open Computers and Software Inventory Next Generation), a powerful open-source asset management and package deployment solution. Since 2001, OCS Inventory has enabled administrators to discover, track, and manage their hardware and software assets across complex infrastructures.

The OCS Inventory project is undergoing a major evolution. To ensure stability and support for all users, we are maintaining both the legacy and the reworked branches in parallel:

• OCS Inventory 3.0 [Active Rework]
  • Status:
  • Focus: A complete technological redesign focusing on RESTful API-driven architecture, cross-platform Dart-based agent execution, unified data models, and a modern Vue.js web UI.
• OCS Inventory 2.X [Legacy Branch]
  • Status:
  • Focus: Maintenance mode.
  • Support & EOL: Version 2.X will be maintained for 5 years. During this EOL period, it will receive critical security patches and major functional bug fixes. This guarantees operational continuity while you plan your transition.

OCS Inventory 3.0 is a complete overhaul of our architecture to embrace modern engineering practices, remove technical limitations, and enhance developer onboarding and community contributions.

For more details, see the dedicated Key Architecture Shift documentation.

Explore the components of OCS Inventory 3.0:

• Server Backend API: The single entry-point for console communications and agent posts, exposing a fully open RESTful API.
• Server Frontend Console: The brand-new Vue.js web dashboard for system reporting and administration.
• Unified Agent Rework: The cross-platform Dart agent focusing on efficient and unified local inventory collection.
• SNMP Scanner: Standalone scanner tool for agentless inventory, unifying SNMP network devices into the core catalog.
• Server Packages: Deployment files, configurations, and OS packages (Debian, etc.) to install the V3 stack.

We provide comprehensive paths to guide you through installation and transition:

• Quickstart & Installation: Refer to the setup guides covering OS package installation and database configurations (like PostgreSQL).
• Backward Compatibility: Version 3.0 includes a backward compatibility module allowing legacy 2.x agents to report standard inventory data directly to the new 3.0 backend.

For detailed steps and diagrams, see the dedicated Migration Strategies documentation.

1. Parallel Agents (Recommended for validation): Run legacy 2.x and reworked 3.x agents side-by-side on the same assets to validate inventories with zero downtime.
2. Proxy Duplication: Position a reverse proxy in front of your legacy server. Duplicate incoming XML inventory data, forwarding one flow to V2 and another to the V3 REST API.
3. Legacy Endpoint Redirection: Keep the legacy hostname pointing to a reverse proxy that redirects legacy agent traffic into the V3 backend wrapper.
4. Full Replacement: Uninstall 2.x agents/server and replace them with the 3.0 stack (optimal for smaller, automated fleets).

Although the core development effort has transitioned to the 3.0 architecture, OCS Inventory 2.0 remains a stable workhorse. All legacy community portals, documentation sites, and repositories will remain active and online.

• OCS Inventory Server (Legacy PHP/Perl)
• OCS Inventory Reports (Legacy Web UI)
• Windows Agent (Legacy C++)
• Unix Agent (Legacy Perl)

OCS Inventory is licensed under the GPLv2 License.