-
Notifications
You must be signed in to change notification settings - Fork 15
Demo Data
FreeITSM can seed itself with realistic sample data so you can evaluate it, test a feature, or take screenshots without hand-building a database first. It lives at System β Demo Data (administrators only).
Use it on an evaluation or fresh install, not a live one. Importing a module replaces that module's data β it clears the relevant tables first (see What "import" does). It is perfect for a demo or a throwaway Docker instance; it is not something to run against a system holding real tickets.
Every other module builds on Core Data, so import it first. It seeds the people and structure the rest of the app hangs off:
-
4 analysts (log in with any of them β password
demo1234) and 15 end users (portal requesters) - 5 departments, 5 ticket types, 4 ticket origins
- 2 teams β Service Desk and Escalation Team β wired up as a worked role-based-access example (below)
Then import whichever module areas you want β Tickets, Assets, Knowledge, Changes, Calendar, CMDB, Contracts, and so on β from the cards below Core Data.
Since the demo is where people first meet FreeITSM's permissions, Core Data now seeds a realistic RBAC setup rather than a flat one β a pattern you can explore under System β Analysts / Teams / Roles and copy for your own organisation:
| Service Desk | Escalation Team | |
|---|---|---|
| Members | James Smith, Sarah Williams | Michael Jones, Laura Brown |
| Module access | a first-line subset β Watchtower, Tickets, Assets, Knowledge, Changes, Problems, Calendar, Morning checks, Service status, Wiki, Tasks, CMDB | all modules |
| Role | Service Desk β no settings access (use the modules, change no settings) | Escalation Team β every settings capability (full settings access across the app) |
Two principles the example is built to demonstrate:
- No demo analyst is an administrator. Administrators bypass all permissions; a realistic desk grants access deliberately instead.
- Access comes from the team, not the person. Each analyst has "all modules" turned off at their own level β what they can reach is granted by the team they're in. That's how a real install should be set up, because it scales: change the team, and everyone in it changes with it.
So an Escalation analyst can open and configure anything; a Service Desk analyst can work in the day-to-day modules but can't change their settings β exactly the split most service desks run.
- It reads
database/demo-data/<module>.jsonand writes the rows in one transaction β if anything fails, the whole import rolls back and nothing changes. - It clears that module's tables first, so importing is repeatable: run it again and you get a clean copy, not duplicates.
- Your administrator account is preserved. The import matches it by username and leaves it untouched, so you never lock yourself out.
- Dates are relative to today, so a freshly imported ticket looks like it came in recently, not in 2019.
- On a throwaway Docker instance (
docker compose up), import Core Data and you can log straight in asadmin/freeitsm, or as a demo analyst withdemo1234. - If an import ever fails or seems to do nothing, the SSL / HTTPS-style Debug Tools have a dedicated Demo Core Data Import diagnostic (System β Debug tools β D001) that traces exactly what happened.
- Building your own demo data, or adding it for a new module? See the Demo Data β Developer Guide.
FreeITSM β an open-source IT Service Management platform Β· github.com/edmozley/freeitsm Β· MIT licence
- Installation
- β° Scheduled tasks (cron jobs)
- Architecture
- AI Providers
- Internationalisation (i18n)
- Timezones & Time Handling
- Theming & Dark Mode
- β¨οΈ Command palette (βK)
- π Searching inside tickets
- π Attached documents
- MobileβFriendly
-
Security
- Layer 1 β which modules you can enter
- β³ π§© Module Access Control
- β³ π οΈ Module Access β Developer Guide
- Layer 2 β what you can administer
- β³ π Roles & Permissions
- β³ π οΈ Roles β Developer Guide
- β³ π€ Why capabilities are constants
- Layer 3 β the System module
- β³ π Admin Access Control
- Hardening
- β³ π Security review response 2026-08
- β³ π‘οΈ Security hardening 2026-08
- β³ π οΈ Security hardening 2026-08 β Developer Guide
- β³ π‘οΈ Round three β plain English
- β³ π οΈ Round three β Developer Guide
- Single Sign-On (SSO)
- ποΈ LDAP & Active Directory
- Browser Extension
- API Reference
-
π REST API β how it works
- β³ π« REST API: Tickets
- β³ π» REST API: Assets
- β³ π΄ REST API: Problems
- β³ π REST API: Changes
- β³ π REST API: Knowledge
- β³ β REST API: Tasks
- β³ ποΈ REST API: CMDB
- β³ π REST API: Contracts
- β³ ποΈ REST API: Calendar
- β³ πΏ REST API: Software
- β³ π¦ REST API: Service Status
- β³ βοΈ REST API: Morning Checks
- β³ π REST API: Forms
- β³ βοΈ REST API: Workflow
- β³ πΊοΈ REST API: Network Mapper
- β³ π§ Using the API docs page
- β³ π OpenAPI specification
- β³ β OpenAPI: kept correct
- β³ π οΈ Maintaining the catalogue
- Watchtower
-
Tickets
- β³ Mailbox Authentication
- β³ π€ Email send log
- β³ Basic IMAP mailboxes
- β³ Email rendering & images
- β³ SLA Management
- β³ WhatsApp channel
- β³ π¬ Web chat channel
- β³ π£ Slack channel
- β³ π Linking tickets
- β³ ποΈ Canned responses
- β³ βοΈ Limiting replies to particular senders
- β³ βοΈ Email signatures
- β³ π The public web address
- β³ π Raising a ticket for someone else
- β³ π Merging tickets
- β³ β Splitting tickets
- β³ β Selecting several tickets
- β³ π οΈ Snoozing tickets β Developer Guide
- β³ π₯ Collision detection
- β³ β±οΈ Time tracking
- Problem Management
- Tasks
- Assets
- Knowledge
- Change Management
- Calendar
- Morning Checks
- Reporting
- Software
- Forms
- Contracts
- Service Status
- π Notifications
- π¨ War Room
- Self-Service Portal
- LMS
- Process Mapper
- CMDB
- Network Mapper
- Workflows
- Issue trackers (Jira, Azure DevOps)
- System
-
Overview
- β³ π Progress tracker
- β³ Concepts & vocabulary
- β³ Email routing & mailboxes
- β³ Settings: global vs per-company
- β³ Users & self-service
- β³ Staff cross-company access
- β³ Worked examples
- β³ Pitfalls & gotchas
- β³ Scope: what it's for
- β³ π οΈ Developer Guide (make a module multi-company)
- β³ ποΈ Case study: CMDB (a linked graph)
- β³ π§ͺ Test harness (prove it's isolated)