Getting Started with Arctyk ITSM¶

Version: Arctyk ITSM v0.6.0+
Last Updated: January 2026

Welcome to Arctyk ITSM! This guide will help you get up and running quickly.

What is Arctyk ITSM?¶

Arctyk ITSM is a modern, open-source IT Service Management platform built with Django. It provides a comprehensive ticket management system with features like:

• 🎫 Full Ticket Lifecycle Management - Track issues from creation to closure
• 💬 Two-Tier Comments - Public comments and internal staff notes (v0.6.0+)
• ⏱️ SLA Tracking - Monitor response and resolution times (v0.6.0+)
• 📊 Project Organization - Group tickets by project
• 🔄 Recurring Tickets - Automate routine tasks
• 📦 Asset Management - Track IT inventory
• 📈 Reports & Analytics - Gain insights from your data

Quick Links¶

For New Users¶

• Quickstart Guide - Get Arctyk ITSM running in minutes
• Docker Installation - Detailed setup instructions
• Features Overview - Explore what Arctyk ITSM can do

For Developers¶

• Development Setup - Set up your dev environment
• Contributing Guide - How to contribute
• Architecture Overview - System design and structure

For Administrators¶

• Production Deployment - Deploy to production
• Environment Configuration - Configure settings
• Security Hardening - Secure your installation

System Requirements¶

Minimum Requirements¶

• Docker: v28+
• Docker Compose: v2.x
• RAM: 2GB minimum
• Disk: 5GB available space

Recommended Requirements¶

• RAM: 4GB+
• Disk: 20GB+ for production
• CPU: 2+ cores

Installation Methods¶

Docker (Recommended)¶

The easiest way to get started:

git clone https://github.com/Arctyk-ITSM/arctyk-itsm.git
cd arctyk-itsm
cp .env.example .env
docker compose up -d

See Quickstart Guide for details.

Manual Installation¶

For development or custom deployments:

git clone https://github.com/Arctyk-ITSM/arctyk-itsm.git
cd arctyk-itsm
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python src/manage.py migrate
python src/manage.py runserver

See Local Setup Guide for details.

First Steps After Installation¶

1. Create Superuser

   docker compose exec web python src/manage.py createsuperuser
   

2. Access the Application

   • Navigate to http://localhost:8000
   • Log in with your superuser credentials

3. Create Your First Ticket

   • Click "New Ticket" in the navigation
   • Fill in the title and description
   • Submit and explore the interface

4. Explore Features

   • Try adding comments (public and internal)
   • Create a project
   • View the ticket history
   • Check out the SLA tracking

Getting Help¶

Documentation¶

• Full Documentation
• FAQ
• Troubleshooting Guide

Community¶

• GitHub Discussions
• Discord Community
• Issue Tracker

Contributing¶

• Contributing Guide
• Code of Conduct
• Development Workflow

What's New in v0.6.0¶

✨ Ticket Comments System - Full two-tier comment system with public comments and internal notes

⏱️ SLA Tracking - Response and resolution target tracking with lifecycle timestamps

📝 Comment Edit History - Complete audit trail of all comment modifications

🎨 UI Improvements - Enhanced user interface and better accessibility

📚 Documentation Updates - Comprehensive documentation for all features

See Changelog for complete details.

Next Steps¶

Ready to dive deeper? Here are some recommended next steps:

1. Learn the Features: Explore the Features Overview
2. Configure Your Instance: Review Environment Configuration
3. Customize the Workflow: Understand Ticket Workflows
4. Set Up Integrations: Configure email notifications and external integrations
5. Plan for Production: Review Production Deployment

Welcome to Arctyk ITSM! We're excited to have you here. 🚀