Skip to content

Discord Ferry

Migrate your Discord server to Stoat (formerly Revolt) — messages, channels, roles, emoji, attachments, and all.

One-click app for Windows and Mac. Command-line interface for Linux. No coding required.

Get Started in 3 Steps

  1. Install Ferry — download the app for Windows, macOS, or Linux
  2. Set up Stoat — find your Stoat API URL (the address Ferry uses to connect) and user token (a secret key your browser saves when you log in — no bot or app creation needed). New to Stoat? Create a free account.
  3. Run your first migration — enter your Discord and Stoat credentials, click Migrate

Already have DiscordChatExporter (DCE) exports? See Offline Migration to skip the export step.

How Long Does It Take?

Ferry processes multiple channels in parallel (configurable, default 3 concurrent). Typical throughput: ~3-5x faster than sequential. Stoat limits how fast data can be sent to protect the service, which sets the overall pace:

Messages Estimated time
1,000 ~6 minutes
10,000 ~1 hour
100,000 ~8-10 hours

Ferry can pause and resume — close it anytime and pick up where you left off.

What Gets Migrated?

Discord feature What happens
Text channels Recreated on Stoat with the same names and topics
Categories Recreated in the same order as on Discord, with channels grouped the same way
Roles All server roles recreated — even roles nobody posted with — with colours, hierarchy, hoisting ("display separately"), image icons, and Discord permissions translated to Stoat equivalents
Channel permissions Per-role and @everyone overrides migrated
NSFW channels NSFW flag preserved
Server description & NSFW flag Copied to the new Stoat server
Slowmode Per-channel slowmode settings preserved
Voice user limits Per-channel user limits preserved
Messages + authors Each message shows the original author's name and avatar
File attachments Uploaded to Stoat's file storage
Custom emoji Uploaded (up to 100 — the most-used, uploadable emoji are kept)
Pinned messages Re-pinned in the correct channels
Replies Reply links preserved between messages
Reactions Shown as text summary by default, or applied via API (Stoat allows at most 20 reactions per message)
Embeds Flattened to Stoat format with thumbnails and images uploaded
Polls Rendered as formatted text
Threads Converted to text channels, merged into parent, or archived as markdown — your choice
Forum posts Grouped into dedicated categories with an index channel
Voice channels Created, but may not work yet (known Stoat bug)
Stickers Image uploaded, or text fallback for animated/missing
Server banner Uploaded from Discord API when a Discord token is provided
Original timestamps Shown at the start of each message (e.g. *[2024-01-15 12:00 UTC]*)

Some of these need a Discord token to read live server data: role hoisting and icons, roles nobody posted with, server description, category ordering, slowmode, and voice user limits. In offline mode (export folder only), Ferry migrates what the export contains and skips the rest with a warning.

Reliability Features

Ferry is built to handle large migrations safely:

  • Pause and resume — close Ferry anytime, pick up where you left off
  • Parallel channel sends — processes multiple channels concurrently (3x–5x faster)
  • Tunable performance — concurrency, reaction mode, thread filtering, and checkpointing are all adjustable via CLI flags or the GUI's Advanced Options — see the CLI reference
  • Incremental migration — only migrate new messages since the last completed run
  • Pre-creation review — summary and confirmation before anything is created on Stoat
  • Migration report — human-readable migration_report.md with a fidelity score
  • Invite link — Ferry creates an invite to your new Stoat server when the migration finishes (on by default; turn off with --no-create-invite)
  • Failed-message recovery — messages that fail to send are tracked and automatically re-sent on the next --incremental run
  • Message splitting — messages over 2000 characters are split, not truncated
  • Migration lock — prevents two Ferry instances from targeting the same server
  • Circuit breaker — automatic backoff on API failures, no indefinite blocking
  • Rollback — undo a migration with ferry rollback (or the GUI "Rollback this migration" button) — deletes Ferry-created channels, roles, and emoji from the Stoat server
  • Post-migration stats — ferry stats <output-dir> prints a console-friendly summary (entity counts, fidelity score, per-channel breakdown, error preview, elapsed time) from a completed migration — useful for support, scripting, and quick sanity checks without re-opening the report
  • Server blueprints — export your server structure as a reusable template

Guides

Reference