Skip to content

Repository files navigation

Rustmail

Rustmail

A modern Discord modmail bot written in Rust

Discord Release License


Overview

Rustmail is a Discord modmail bot that enables staff teams to manage support tickets through private channels. Users send direct messages to the bot, which creates dedicated channels for staff to respond and track conversations.

Key Features

  • Dual-server or single-server mode - Separate community and staff servers, or run everything on one server
  • Web administration panel - Manage tickets, configuration, and permissions through a browser
  • Message editing and deletion - Full control over ticket messages with change tracking
  • Scheduled closures and reminders - Automate ticket management workflows
  • Multi-language support - 10 languages available (EN, FR, ES, DE, IT, PT, RU, ZH, JA, KO)
  • REST API - Integrate with external tools and automation

Quick Start

1. Download and run

Download the latest release for your platform from Releases, then run the executable:

./rustmail

2. Follow the setup wizard

If no config.toml is found, Rustmail launches a built-in setup wizard and prints a one-time URL to the console:

No configuration found.
Setup wizard available at http://0.0.0.0:3002/setup?token=...

Open that URL in your browser to configure your bot token, server mode, ticket settings, web panel, and language — the wizard writes a ready-to-use config.toml for you and restarts the bot automatically once you're done.

The bot creates its SQLite database automatically on first run.


Documentation

Section Description
Installation Download and setup instructions
Configuration Detailed configuration guide
Commands Complete command reference
Server Modes Single vs dual-server setup
Web Panel Administration panel guide
API Reference REST API documentation
Docker Deployment Container deployment
Architecture Technical overview

Full documentation is available in the docs directory or on the website.


Support

For help and discussions, join the Discord server.


License

This project is licensed under the AGPLv3 License.

The rustmail_panel i18n module includes code derived from i18n-rs, licensed under MIT.

About

A Rust Discord bot for ticket management with self-hosted web dashboard included

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages