How edmozley/freeitsm works
FreeITSM is a self-hosted IT service-management platform: staff handle operational work while end users raise and follow requests through a self-service portal and other channels. A central workflow runs from incoming requests to ticket handling and automation; adjacent modules cover assets, knowledge, changes, problems and tasks. The README also documents forms, contracts, LMS, CMDB and integrations as major product areas. Edges reflect documented capabilities or visible source references; many module internals and their wiring were not sampled, so those relationships are omitted.
Main entry points: tickets Ticket operations · db.php MySQL data store · ingest.php Channel ingestion · functions.php Shared runtime
Components 22
User experience
- Ticket workspace
tickets - Self-service portal
self-service/index.php - Watchtower
watchtower/index.php
Service operations
- Ticket operations
api/tickets - Channel ingestion
includes/messaging/ingest.php - Notifications
includes/services/notifications.php - Workflow engine
workflow/includes/engine.php
Shared platform
- MySQL data store
includes/db.php - Shared runtime
includes/functions.php - Tenant context
includes/tenancy.php
Business modules
- Asset management
asset-management - Knowledge base
knowledge/index.php - Change management
change-management/index.php - Problem management
problem-management/index.php - Tasks
tasks/index.php - Forms
forms/index.php - Contracts
contracts/index.php - Learning management
api/lms - Configuration database
api/cmdb - External integrations
includes/integrations/integrations.php
Other components
- Staff analyst
- End user
Connections 21
- End user → Self-service portal: submits requests
- Self-service portal → Ticket operations: creates tickets
- Staff analyst → Ticket workspace: handles tickets
- Ticket workspace → Ticket operations: manages tickets
- Channel ingestion → MySQL data store: stores ticket messages
includes/messaging/ingest.php - Channel ingestion → Ticket operations: creates or updates tickets
includes/messaging/ingest.php - Ticket operations → Workflow engine: dispatches events
workflow/includes/engine.php - Staff analyst → Watchtower: reviews attention
- Staff analyst → Asset management: manages assets
- Staff analyst → Knowledge base: uses knowledge
- Staff analyst → Change management: manages changes
- Staff analyst → Problem management: manages problems
- Staff analyst → Tasks: manages work
- Staff analyst → Forms: builds forms
- Staff analyst → Contracts: manages contracts
- Staff analyst → Learning management: uses training
- Staff analyst → Configuration database: manages configuration
- Ticket operations → MySQL data store: reads and writes
- Shared runtime → MySQL data store: connects to
includes/functions.php - Shared runtime → Tenant context: uses tenant context
includes/functions.php - Workflow engine → External integrations: uses integrations
workflow/includes/engine.php