Getting Started

What you need to run FreeITSM

Fastest Way to Get Started: Docker

Three commands. No manual configuration. Works on Linux and Windows.

git clone https://github.com/edmozley/freeitsm.git
cd freeitsm
docker compose up --build -d

View Full Docker Guide →

Manual Setup

If you prefer to install FreeITSM on your own web server, here's what you'll need:

System Requirements

  • Database: MySQL 8.0+ or MariaDB 10.5+
  • Web Server: IIS with PHP configured, or WAMP Server
  • Email Integration (pick one):
    • Microsoft 365: Azure Tenant (setup guide) + Exchange Mailbox (setup guide) + Enterprise Application (setup guide)
    • Google Workspace: Google Cloud Console project with Gmail API enabled + OAuth credentials
  • OpenAI Account: Required for AI-powered features – Setup guide
  • Anthropic Account: Required for Claude AI integration – Setup guide
  • NirSoft UninstallView: Required for the Software Inventory module – Download from NirSoft

Next Steps

Once you have the required components in place:

  1. Download FreeITSM from GitHub
  2. Configure your MySQL database
  3. Set up your web server (IIS or WAMP)
  4. Add your OpenAI and Anthropic API keys to the configuration
  5. Set spending limits on both AI service accounts

AI API Costs

FreeITSM uses AI services (OpenAI and Anthropic) that charge per token/request. These costs are YOUR responsibility.

If you do not fully understand how AI API tokens work, how costs accumulate, or how to monitor and control spending, DO NOT proceed until you have consulted with someone who does.

Before using this software, you MUST:

  • Set spending caps/limits on your OpenAI and Anthropic accounts
  • Understand the pricing model for both services
  • Monitor your usage regularly
  • Be prepared to pay for API usage costs

I take absolutely NO responsibility for any unexpected costs, charges, or expenses you incur through using this software. By using FreeITSM, you accept full financial responsibility for all API usage.

This software is free. The AI services it connects to are not. Use at your own risk.

→ Read the complete API setup guide with step-by-step instructions

Software Inventory

FreeITSM includes a Software Inventory module that tracks installed software across your estate. To automatically collect and upload software data from your machines, we've provided a ready-made PowerShell script.

→ View the Software Inventory PowerShell Script

Microsoft Intune (optional)

If your estate is already managed through Microsoft Intune, FreeITSM can sync managed devices and detected software directly via the Microsoft Graph API — useful for agent-less devices or as a complement to the PowerShell inventory script above. This is entirely optional and is only worth setting up if you already use Intune.

→ View the Microsoft Intune Setup Guide

Remember: This is a passion project with no formal support. You're responsible for your own setup, configuration, and any costs associated with running the software.