Try the Demo Get GOTRS

Migration Guide

Migrate from OTRS to GOTRS - multiple options available.

Getting Started

First steps with GOTRS - installation, initial setup, and your first ticket.

Deployment

Production deployment guides for Docker, Kubernetes, and air-gapped environments.

Admin Guide

Configure queues, users, groups, automation, and system settings.

API Reference

REST API documentation for integrations and custom development.

Migration Guide

Moving from OTRS to GOTRS - import your existing data and configuration.

FAQ

Frequently asked questions and common troubleshooting tips.

OTRS to GOTRS Migration Guide

This guide covers options for migrating from OTRS to GOTRS.

Migration Options

Option 1: Connect to Existing OTRS Database (Simplest)

Point GOTRS at your existing OTRS database server. This avoids any data migration:

  1. Configure GOTRS database connection to use your existing OTRS MySQL/PostgreSQL instance
  2. GOTRS is schema-compatible with OTRS Community Edition
  3. Point GOTRS attachment storage at your OTRS file store
  4. Users can authenticate against OTRS directly or be migrated

Advantages:

  • Zero data migration
  • Instant cutover
  • No risk of data loss

Option 2: Dump and Load

  1. Dump OTRS database: mysqldump otrs_db > otrs_backup.sql
  2. Restore to new MariaDB/MySQL or PostgreSQL database
  3. Copy attachment files to GOTRS storage location
  4. Run database migrations if needed

Option 3: Use GOTRS Migration Tool

GOTRS includes migration tooling via Makefile targets (run from the gotrs-ce directory):

# First, analyze your OTRS dump to see what will be migrated
make migrate-analyze SQL=/path/to/otrs_backup.sql

# Dry run - preview the import without making changes
make migrate-import SQL=/path/to/otrs_backup.sql DRY_RUN=true

# Import the data
make migrate-import SQL=/path/to/otrs_backup.sql

# Force import (skip confirmations)
make migrate-import-force SQL=/path/to/otrs_backup.sql

# Validate the migration
make migrate-validate

Note: These tools run inside the toolbox container with access to your database. Always test with a backup first!

Prerequisites

  • OTRS 6.x or later
  • Database access (MySQL or PostgreSQL)
  • File system access to OTRS attachments
  • Docker/Podman for GOTRS

Getting Help