discord-ferry 1.4.0

Migrate Discord servers to Stoat (formerly Revolt)

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

---

Download

Platform	Download	Size
Windows	Ferry.exe	~25 MB
macOS	Ferry.zip	~25 MB
Linux / pip	pipx install discord-ferry	—

---

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 — your Stoat secret key. The step-by-step guide shows exactly where to find it.

Step 2: Ferry exports your server automatically

Ferry downloads and runs DiscordChatExporter behind the scenes — no manual steps.

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 DiscordChatExporter (DCE) exports? Ferry also supports offline mode — just point it at your export folder.

---

How long does it take?

About 1 message per second. Stoat limits how fast data can be sent to protect the service, which sets this pace. That means:

• 1,000 messages ~ 17 minutes
• 10,000 messages ~ 3 hours
• 100,000 messages ~ 28 hours (run overnight!)

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

---

What gets migrated?

Feature	Status
Text channels	Supported
Categories	Supported
Roles (with colours and permissions)	Supported — Discord permissions translated to Stoat equivalents
Channel permissions	Supported — per-role and @everyone overrides migrated
NSFW channels	Supported — NSFW flag set during channel creation
Messages + author names	Supported (each message shows the original author's name and avatar)
File attachments	Supported
Custom emoji	Supported (up to 100)
Pinned messages	Supported
Replies	Supported
Reactions	Supported (without per-user attribution)
Embeds (with media)	Supported (thumbnails and images uploaded)
Polls	Supported (rendered as formatted text)
Threads	Supported (converted to text channels)
Forum posts	Supported (grouped into dedicated categories)
Voice channels	Partial (created but do not work yet — known Stoat bug)
Stickers	Image upload with text fallback for Lottie/missing
Original timestamps	Shown in message text, not metadata
Pre-creation review	Summary and confirmation before anything is created on Stoat
Server blueprints	Export migration structure as reusable JSON templates

---

Detailed Guides

• Exporting from Discord manually (offline mode)
• Setting up your Stoat instance
• Your first migration (full walkthrough)
• GUI guide (every screen explained)
• CLI reference
• Migrating large servers (100k+ messages)
• Self-hosted tips
• Troubleshooting

---

Contributing

We welcome contributions! See CONTRIBUTING.md.

---

License

MIT