Discord Ferry

CI Latest release Python 3.11+ License: MIT

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. Your data stays on your machine.

Download

Platform Download Size
Windows Ferry.exe ~48 MB
macOS, Apple Silicon (M1–M5) Ferry.zip ~48 MB
macOS, Intel Ferry.zip ~48 MB
Linux / pip pipx install discord-ferry ~2 MB

macOS: the first launch is blocked by Gatekeeper because Ferry is not notarized. Click Done, not "Move to Bin", then approve it once under System Settings → Privacy & Security → Open Anyway. Full walkthrough in the installation guide.

What is Stoat?

Stoat (formerly Revolt) is an open-source chat platform, like Discord, but community-owned. You can use the official hosted service or run it on your own server. Ferry moves your entire Discord server there.

New to Stoat? Create a free account or self-host your own instance.

How It Works

Step 1: Enter your credentials

Launch Ferry. You'll need four things:

  • Discord user token + server ID, a token is a secret key that lets Ferry access your account. Ferry shows you how to find both.
  • Stoat API URL, the web address Ferry uses to talk to Stoat. Use https://api.stoat.chat for the official service, or your own domain if you run your own Stoat instance.
  • Stoat user token, a secret key your browser saves when you log in to Stoat. No bot or app creation needed, you just copy it from your browser. The step-by-step guide shows exactly where to find it.

Step 2: Ferry exports your server automatically

Ferry downloads and runs the Discord server export tool, DiscordChatExporter (DCE), behind the scenes. No manual steps are needed.

Step 3: Click Migrate

Messages, channels, roles, emoji, and attachments migrate to Stoat. Each message shows the original author's name and avatar. Pins are preserved.

Already have DCE exports? Ferry also supports offline mode, just point it at your export folder.

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. That means:

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

Ferry can pause and resume, close it anytime, 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 Active polls are unavailable; closed-poll notifications keep DCE's fallback text and embeds
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 one command (or one click in the GUI), 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

Beyond migration

Ferry ships several extra commands alongside migrate:

  • ferry validate, check an export before migrating: counts, warnings, and a time estimate. No network calls.
  • ferry check, after a migration, ask the live Stoat server whether every channel, role, category, emoji and message tail Ferry recorded is still there. Read-only.
  • ferry repair, re-send messages and re-create channels or roles that ferry check found missing. Refuses to touch renames or a rolled-back migration.
  • ferry retry, re-send the messages Ferry parked in the dead-letter queue after a failed send.
  • ferry probe, diagnose a live Stoat instance (upload size limits, rate limits, voice support, webhooks). Useful for self-hosters.
  • ferry build, create a fresh Stoat server from a preset template (gaming, community, or education) or a blueprint file.
  • ferry export-blueprint, turn a Discord export into a reusable server blueprint (structure only, no messages).
  • ferry tls-check, report which certificate authorities Ferry currently trusts, so you can diagnose an unable to get local issuer certificate error before touching proxy or antivirus settings.

See the CLI reference for all commands and options.

Detailed Guides

Contributing

We welcome contributions! See CONTRIBUTING.md.

License

MIT

Sponsor

If Discord Ferry has helped you, sponsor Peter's open-source work.

Project links

Data verified by PyPI on Aug 31, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.41.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for PeterSterkenburg from gravatar.com PeterSterkenburg

Credits

Author: Peter Sterkenburg

GitHub Statistics

Data verified by PyPI on Aug 31, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev docs mutation native

Tags

discord gui migration revolt stoat

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discord_ferry-2.37.3.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

discord_ferry-2.37.3-py3-none-any.whl (285.4 kB view details)

Uploaded Python 3

File details

Details for the file discord_ferry-2.37.3.tar.gz.

File metadata

  • Download URL: discord_ferry-2.37.3.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for discord_ferry-2.37.3.tar.gz
Algorithm Hash digest
SHA256 7d91b2b239ec7e63f429b40131ba57fe3f0006fcae5274829297baf0aa32bdfa
MD5 22e900ba20efe740822ad3d445602b6f
BLAKE2b-256 2c1fd3d499574f918cdaffb8d0ec4e1cb997ded9f5f553d515a2ac8166515051

See more details on using hashes here.

Provenance

The following attestation bundles were made for discord_ferry-2.37.3.tar.gz:

Publisher: release.yml on nordscope-fi/Discord-stoat-ferry

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file discord_ferry-2.37.3-py3-none-any.whl.

File metadata

  • Download URL: discord_ferry-2.37.3-py3-none-any.whl
  • Upload date:
  • Size: 285.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for discord_ferry-2.37.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6de6c5eb75c398184eda46926a96e206cd069a4bdf29fbc256c5bbc3755654cd
MD5 6d9fb5baef35d3eb689044b97cc1c7ca
BLAKE2b-256 0587bf0920fd1c627425d16f8ae9aca2d21ead2a75a7e5978340d986bd7f1ac3

See more details on using hashes here.

Provenance

The following attestation bundles were made for discord_ferry-2.37.3-py3-none-any.whl:

Publisher: release.yml on nordscope-fi/Discord-stoat-ferry

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2.41.0

2 files

2.40.6

2 files

2.40.5

2 files

2.40.4

2 files

2.40.3

2 files

2.40.2

2 files

2.40.1

2 files

2.40.0

2 files

2.39.0

2 files

2.38.3

2 files

2.38.2

2 files

2.38.1

2 files

2.38.0

2 files

This release

2.37.3 This release

2 files

2.37.2

2 files

2.37.1

2 files

2.37.0

2 files

2.36.0

2 files

2.35.7

2 files

2.35.6

2 files

2.35.5

2 files

2.35.4

2 files

2.35.3

2 files

2.35.2

2 files

2.35.1

2 files

2.35.0

2 files

2.34.0

2 files

2.33.0

2 files

2.32.0

2 files

2.31.0

2 files

2.30.0

2 files

2.29.0

2 files

2.27.0

2 files

2.26.0

2 files

2.25.0

2 files

2.24.0

2 files

2.23.0

2 files

2.22.0

2 files

2.21.0

2 files

2.20.0

2 files

2.19.17

2 files

2.19.16

2 files

2.19.15

2 files

2.19.14

2 files

2.19.13

2 files

2.19.11

2 files

2.19.10

2 files

2.19.9

2 files

2.19.8

2 files

2.19.7

2 files

2.19.6

2 files

2.19.5

2 files

2.19.4

2 files

2.19.3

2 files

2.19.2

2 files

2.19.0

2 files

2.17.0

2 files

2.16.0

2 files

2.15.0

2 files

2.14.7

2 files

2.14.5

2 files

2.14.4

2 files

2.14.3

2 files

2.14.2

2 files

2.14.1

2 files

2.14.0

2 files

2.13.1

2 files

2.13.0

2 files

2.12.1

2 files

2.12.0

2 files

2.11.1

2 files

2.11.0

2 files

2.10.0

2 files

2.9.0

2 files

2.8.5

2 files

2.8.4

2 files

2.8.3

2 files

2.8.2

2 files

2.8.1

2 files

2.8.0

1 file

2.7.1

2 files

2.7.0

2 files

2.6.17

2 files

2.6.16

2 files

2.6.15

2 files

2.6.14

2 files

2.6.13

2 files

2.6.12

2 files

2.6.11

2 files

2.6.10

2 files

2.6.9

2 files

2.6.8

2 files

2.6.7

2 files

2.6.6

2 files

2.6.5

2 files

2.6.4

2 files

2.6.3

2 files

2.6.2

2 files

2.6.1

2 files

2.6.0

2 files

2.5.1

2 files

2.5.0

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.0

2 files

2.2.12

2 files

2.2.10

2 files

2.2.9

2 files

2.2.8

2 files

2.2.7

2 files

2.2.6

2 files

2.2.5

2 files

2.2.4

2 files

2.2.3

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.6

2 files

2.1.5

2 files

2.1.4

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.2

2 files

1.4.0

2 files

1.3.0

2 files

1.2.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page