Trac2GitLab

A tool to synchronize tickets, wikis and related data from a Trac instance (via XML-RPC) into a GitLab project.

Current Features

Exporter

• Export tickets from Trac as JSON files (including content history and comments)
• Export content of wiki pages from Trac as markdown files (including history)
• Export metadata of wiki pages from Trac as JSON files (including history)
• Export milestones as JSON files
• Concurrent export operations for faster migration (speed might be limited by Trac XML-RPC)
• Download attachments
• Configurable via YAML

Importer

• Import milestones into GitLab projects (updates if already exist and content differs)
• Import issues into GitLab projects (updates if already exist and content differs)

Planned Features

Importer

• Add Trac ticket comments to GitLab issues (preserve original authors and timestamps)
• Preserve ticket history in GitLab issues (not supported by the GitLab API)
• Map Trac fields to GitLab labels
• Import wiki pages into GitLab projects
• Preserve wiki page history in GitLab wikis (not supported by the GitLab API)

Compatibility

This package is compatible with:

• TracXMLRPC version: 1.1.9
• Trac core version: 1.2.3

Tested against the plugin installed from: https://trac-hacks.org/wiki/XmlRpcPlugin

If you're using another version, some methods may not be available or may behave differently.

Requirements

• Go 1.23 or later
• Access to a Trac instance with XML-RPC enabled
• GitLab project with API access token

Running the tool (from source)

1. Clone the repository
2. Run make install to install dependencies
3. Run make init to generate a default config or rename config.example.yml to config.yml
4. Configure config.yml with your Trac and GitLab settings
5. Run the commands in your terminal

Trac Exporter:

make export

GitLab Importer:

make migrate

Check the Makefile for more commands and options.