Skip to main content

🔀 Migrating From Open Ticket v3

Welcome to the guide about migrating from Open Ticket v3 to Open Ticket v4.

Since Open Ticket v4 is a complete rewrite, the database & config from v3 is not compatible with v4. This guide will help you transition smoothly while keeping as much of your data as possible.

We try to make this process as user-friendly as possible, but all migrated tickets will sadly enough still have limited functionality. The full v4 experience is only available with newly created tickets.

Migrating From v3

Transfering data & settings from Open Ticket v3

❓ What's New?​

Open Ticket v4 introduces many fundamental changes compared to v3.
Here’s an overview of the most important differences:

🎯 Differences​

FeatureOpen Ticket v3Open Ticket v4
Programming LanguageJavaScriptTypeScript (Compiles to JS for node.js)
Configuration Filesconfig.json & transcriptconfig.json./config/ folder (multiple files)
Database Location./storage/./database/
Plugin Systemv3 Plugins (not compatible)v4 Plugins (10x more advanced)
Buttons & Ticketsv3 Ticket Buttons (not compatible)New Ticket System (v3 tickets won't work)
Log Fileopenticketdebug.txtotdebug.txt

🎉 New Features​

  • 🧩 Very Advanced Plugins
  • 📝 Modal Questions (before ticket creation)
  • ✏️ Close, Delete, Reopen, Claim, ... with reason (previously only possible with close)
  • 📌 Pin & Unpin Tickets
  • ⛔ Blacklist Users
  • 📊 Advanced Statistics
  • 🎨 Even More Customization!
  • ⏱️ Autoclose Revamp & Autodelete
  • 🦇 Pterodactyl Panel Support
  • ⚙️ Improved Config Checker
  • 📋 Fully-Revamped Panels & Options
  • And so much more!

Migrating from Open Ticket v3 requires manual steps. v3 tickets will not work by default in v4 without additional settings & plugins!

📂 Creating A Backup​

Before you start, back up your existing v3 setup to a safe location to ensure you don’t lose anything:

  • config.json, transcriptconfig.json, ./storage/
  • Open Ticket v3 plugins won't work in Open Ticket v4 anymore

🔄 Migrating to Open Ticket v4​

1️⃣ Install Open Ticket v4​

  • Download the latest version of Open Ticket v4 from GitHub.
  • Follow the Setup Guide to install it.
  • Run npm install to install all required dependencies.

2️⃣ Convert Configuration Files​

Since v4 completely changes how configuration works, you cannot reuse config.json and transcriptconfig.json.
Instead, manually recreate your settings in the new config folder:

  • General settings → Moved to ./config/general.json
  • Options → Moved to ./config/options.json
  • Panels/Messages → Moved to ./config/panels.json
  • Transcript settings → Moved to ./config/transcripts.json
  • Ticket questions (NEW) → Available in ./config/questions.json

If you're stuck, try reading the Configuration Guide for more details.

3️⃣ Migrate Tickets (Optional)​

To transfer old tickets from v3 to v4, you can use the OT Migrate v3 plugin. When starting the bot, all tickets will receive a message with the associated instructions.

Ticket migration is limited. Some features will sadly enough not transfer correctly, and migrated tickets will have reduced functionality.

🛠️ Downloading Plugins​

Open Ticket v3 plugins are NOT compatible with v4. You'll have to download all v4 versions from the official plugin repository.

Check the Official Open Ticket Plugins repository for v4-compatible plugins:

support with plugin migration

If you have a v3 plugin and you don't now how to migrate it to v4, please join our discord server and we will help you further!

🚀 Final Steps​

Once everything is set up:

  • Start the bot using npm start or node index.js.
  • Open a test ticket to verify everything works.
  • Migrate existing tickets by clicking the button which appears in valid ticket channels.
  • If you encounter errors, check the new log file: otdebug.txt.

Congratulations! 🎉 You've successfully migrated to Open Ticket v4!
For any additional issues, please join our discord server: