Industrace is a comprehensive Industrial Asset Management System designed for managing and monitoring industrial equipment, networks, and infrastructure. Built with FastAPI backend and Vue.js frontend, it provides a modern, scalable solution for industrial environments.
It was born from a simple observation: most asset management tools are designed for IT, while the industrial world requires different logic — mapping systems against the Purdue model, assessing risk with ICS-specific parameters, and documenting operational infrastructure in a structured way.
👉 Industrace is meant to be a starting point: easy to deploy, preloaded with demo data, and most importantly open to contributions and real-world use cases. We don’t claim to cover everything from day one, but we believe many organizations — large and small — face similar needs.
Industrace was developed combining hands-on expertise in cybersecurity with the support of AI tools throughout the development process.
This means two things:
🛠️ The project was built faster and with broader perspectives, leveraging AI to explore solutions and speed up coding.
🌍 The code and documentation are designed to be clear, structured, and accessible — a direct result of the “AI-assisted” approach.
We like to think of Industrace as an experiment in human + AI co-creation, where the open source community can now take the lead to validate, extend, and adapt it to real-world industrial environments.
Last thing.. Born in Italy, Industrace combines European attention to industrial processes with a global open-source mindset.
- Asset Management: Complete lifecycle management of industrial assets
- Network Mapping: Visual representation of asset connections and communications
- Risk Assessment: Built-in risk scoring and vulnerability assessment
- Multi-tenant Architecture: Support for multiple organizations
- Role-based Access Control: Granular permissions system
- Real-time Monitoring: Live asset status and health monitoring
- Document Management: Asset documentation and photo management
- Audit Trail: Complete activity logging and change tracking
- API-First Design: RESTful API for integration with other systems
- Modern UI: Responsive Vue.js frontend with intuitive interface
Main dashboard showing asset overview, risk scores, and system status
Complete asset lifecycle management with detailed information and connections
Interactive network visualization showing asset connections and communications
Detailed asset view with interfaces, connections, and documentation
Role-based access control with granular permissions management
Complete activity logging and change tracking for compliance
Visual asset placement on floor plans with interactive mapping
Fully responsive interface that works on desktop, tablet, and mobile
- Backend: FastAPI with SQLAlchemy ORM
- Database: PostgreSQL 15+
- Frontend: Vue.js 3 with Vite
- Authentication: JWT-based with role-based access control
- Containerization: Docker and Docker Compose
- API Documentation: Auto-generated with OpenAPI/Swagger
Quick Start? Go to Quick Start Guide for a quick installation in less than 5 minutes.
- Docker and Docker Compose
- 4GB RAM minimum (8GB recommended)
- 20GB disk space minimum
- Port 80 and 443 available (for production)
- Port 5173 and 8000 available (for development)
# Clone the repository
git clone https://github.com/industrace/industrace.git
cd industrace
# Initialize system with demo data
make init
# Access the application
open http://localhost:5173# Start production with Traefik + Let's Encrypt
make prod
# Access the application
open https://industrace.local# Setup custom certificates
make custom-certs-setup
# Start with custom certificates
make custom-certs-start
# Access the application
open https://yourdomain.com# Clone the repository
git clone https://github.com/industrace/industrace.git
cd industrace
# Start the application
docker-compose up -d
# Access the application
open http://localhost:5173# Start development environment
make dev
# Add demo data to existing system
make demo
# Clean system completely
make clean
# Show available commands
make help- URL: http://localhost:5173
- Email: [email protected]
- Password: admin123
Note: Demo data is automatically populated in development environment. The system includes sample sites, areas, locations, manufacturers, suppliers, contacts, assets with interfaces, and network connections for testing purposes.
The system comes pre-populated with comprehensive demo data:
- 3 Sites: Main Production Plant, Research & Development Center, Distribution Warehouse
- 12 Areas: Assembly Lines, Quality Control Lab, Control Room, Maintenance Bay, etc.
- 19 Locations: Control Panels, Quality Stations, Maintenance Bays, etc.
- 8 Assets: PLCs, HMIs, Robots, Switches, Sensors, Servers with realistic specifications
- 10 Interfaces: Network interfaces with IP addresses, MAC addresses, and protocols
- 5 Connections: Network topology showing asset communications
- 4 Manufacturers: Siemens, Rockwell Automation, Schneider Electric, ABB
- 4 Suppliers and 6 Contacts: Complete supply chain information
Complete documentation is available in the docs directory:
- Quick Start Guide - Get up and running in 5 minutes
- Installation Guide - Detailed installation instructions
- User Manual - How to use the application
- API Documentation - Complete API reference
- Development Guide - Development setup and guidelines
- Administration Guide - System administration
- Security Guide - Security best practices
- Custom Certificates - Deploy with internal CA certificates
- Troubleshooting - Common issues and solutions
- Python 3.8+
- Node.js 16+
- Docker and Docker Compose
# Clone and setup
git clone https://github.com/industrace/industrace.git
cd industrace
# Start development environment
make dev
# Run tests
make test
# View logs
make logsmake init # Initialize system with demo data
make dev # Start development environment
make prod # Start production environment
make demo # Add demo data to existing system
make clean # Clean system completely
make test # Run tests
make logs # View logs
make stop # Stop all services
make build # Build containers
make rebuild # Rebuild containers
make status # Show service status
make shell # Open backend shell
make migrate # Run database migrations
make reset-db # Reset database
make restart # Restart services
make info # Show system informationWe welcome contributions! Please see our Contributing Guide for details.
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). This means you are free to use, modify, and distribute the software, but any modifications must also be released under the same license.
See the LICENSE file for details.
- Documentation: docs/
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Complete Asset Management System: Full lifecycle management for industrial assets
- Multi-tenant Architecture: Support for multiple organizations with data isolation
- Role-based Access Control: Granular permissions system (Admin, Editor, Viewer)
- Network Topology Visualization: Interactive network mapping with asset connections
- Risk Assessment Engine: Advanced risk scoring algorithm for industrial assets
- Document Management: Upload and manage asset photos and documents
- Audit Trail: Complete activity logging and change tracking
- Import/Export System: Excel/CSV import with preview and validation
- Print System: Generate PDF reports with QR codes
- PCAP Analysis: Network traffic analysis and protocol detection
- Floor Plan Integration: Visual asset placement on floor plans
- Responsive Design: Works on desktop, tablet, and mobile
- Internationalization: Full Italian and English language support
- RESTful API: Complete API with OpenAPI documentation
- Docker Support: Easy deployment with Docker Compose
- FastAPI backend with PostgreSQL database
- Vue.js 3 frontend with PrimeVue components
- JWT authentication with secure cookies
- Real-time dashboard with charts and metrics
- Comprehensive error handling and validation
- Automated testing framework
- Production-ready Docker configuration
See our Roadmap for planned features and improvements.
- Author: Maurizio Bertaboni
- Patronage: The project is supported by BeSafe S.r.l., focusing on the Pro edition and enterprise services
- Industrace Site: https://besafe.it/industrace
- Contact: [email protected]