Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 3 additions & 8 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,6 @@
* [Heroku](installation/heroku.md)
* [Community Guides](installation/community-guides.md)
* [Updating](updating.md)
* [Getting Started](getting-started.md)
* [Usage](usage-guide/README.md)
* [Plugins](usage-guide/plugins.md)
* [Configuration](usage-guide/configuration.md)
Expand All @@ -31,10 +30,6 @@
* [Config References]()
* [Configuration Variables](config-references/config-vars.md)
* [Color Names](config-references/color-names.md)
* [OLD DOCS](old-docs/README.md)
* [Installation](installation-1.md)
* [Installation (continued)](installation-continued.md)
* [Configure Modmail and Logviewer](configure-modmail-and-logviewer.md)
* [Frequently Asked Questions](<frequently-asked-questions (1).md>)
* [Modmail Usage](modmail-usage.md)
* [Updating](<updating (1).md>)
* [Archived Documentation](old-docs/README.md)
* [Configure Modmail and Logviewer](old-docs/configure-modmail-and-logviewer.md)
* [Frequently Asked Questions](old-docs/frequently-asked-questions-old.md)
17 changes: 10 additions & 7 deletions choose-host/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,25 +63,26 @@ Modmail is a very lightweight bot, very minimal resources are required.

> Do you have more than 1000 members in your server?

If not: you likely do not need more than 512mb of memory and 1 CPU core.
**If not:** you likely do not need more than 512mb of memory and 1 CPU core.

If yes: you can potentially get away with the minimum spec, but you should consider upgrading.
**If yes:** you can potentially get away with the minimum spec, but you should consider upgrading.

> Do you require your Modmail bot to be online with 0 downtime?

If yes: you want to steer away from free hosts, and in most cases, local hosting as well.
**If yes:** you want to steer away from free hosts, and in most cases, local hosting as well.
*Clarification: for our team, "local hosting" is hosting on a computer that you have in your house, not a VPS in a datacenter*

> Do you plan to have significant usage of your bot?

If yes (ie plugins, hundreds of active threads at once - being replied to not sitting dormant, etc): you can potineitally get away with the minimum spec, but you should consider upgrading.
**If yes (ie many plugins, hundreds of active threads at once - being replied to not sitting dormant, etc):** you can potineitally get away with the minimum spec, but you should consider upgrading.

If you aren't sure: Talk with our [community and team](https://discord.gg/nfErcs7mDM).
**If you aren't sure:** Talk with our [community and team](https://discord.gg/nfErcs7mDM).

If no: use the minimum spec above.
**If no:** use the minimum spec above.

> How technical are you?

If you struggle with technology, you may want to consider a PaaS (Platform as a Service) host, which handles the backend of a server for you. If you have strong technical proficiencies, a VPS or local hosting is likely a better fit for you.
If you struggle with technology, you may want to consider a PaaS (Platform as a Service) host, which handles the backend of a server for you. If you have strong technical proficiencies (or a willingness to research and learn), a VPS or local hosting is likely a better fit for you.

{% endstep %}

Expand Down Expand Up @@ -115,6 +116,8 @@ For nearly all cases, we recommend a cheap Virtual Private Server from one of ou
For users who do not wish to pay, we recommend locally hosting the bot from hardware you already own, like a Raspberry Pi, or old computer you can keep running 24/7 in your house.

In situations where you significantly struggle with technology, a PaaS option *may* be better with you. Feel free to consult with our [team](https://discord.gg/nfErcs7mDM) if you don't know if this is the best option for you.

If you want the simplest possible method of getting your bot online, we would recommend one of our two native Modmail hosts, [buymeacoffee.com/modmaildev](https://buymeacoffee.com/modmaildev) or [modmail.lvl.lol](https://modmail.lvh.lol). Both run a panel that is purpose built and custom developed solely for the purpose of running Modmail.
{% endhint %}

{% hint style="danger" %}
Expand Down
20 changes: 17 additions & 3 deletions choose-host/unrecommended-hosts.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,12 @@ description: These hosts are hosts we, and members of our community have had lit
- Repl.it is a provider aimed at hosting websites. Meaning, it does not have the proper tools and features to properly host the Modmail bot.
- This host is particularly problematic, and there have been many documented unexplainable issues that occur when hosting your bot with this method. Because of this it is **strongly discouraged** for use.


### Bot-hosting.net

- [Website](https://bot-hosting.net/)
- bot-hosting.net is a free or low cost hosting provider that bases their hosting platform on the common free and open-source panel [Pterodactyl](https://pterodactyl.io/).
- Hosting on any Pterodactyl panel based host is already challenging, however, bot-hosting.net shares IP addressess among users, which has resulted in high numbers of our users reporting rate limits being applied to their bot. In other words: your bot will randomly stop working with nothing you can do to fix it.


### Wispbyte

- [Website](https://wispbyte.com/)
Expand All @@ -37,7 +35,6 @@ description: These hosts are hosts we, and members of our community have had lit
### Kairo Hositing
- Discord Only
- Kairo Hosting is a discord server based hosting provider that provides free hosting for Modmail bots. However, the Modmail team was provided evidence that the host expressed what is in our opinion, poor security hygiene, by failing to isolate the filesystems of bots. This allows any user hosting with Kairo hosting to access all files, including token and database connection details of all other bots hosted by this provider. This is a major security risk, with this, we have no choice but to not recommend this host.

<details>

<summary>1x Screenshot</summary>
Expand All @@ -46,6 +43,23 @@ description: These hosts are hosts we, and members of our community have had lit

</details>

<details>

<summary>Stephen from the Modmail Team's Update on May 30th, 2026</summary>

> The Modmail team always attempts to work in good faith with a host when we find a security vulnerability. We have been working with this host and it appears they are making a good faith attempt to address the security vulnerabilities we have found. Even after these fixes, we still advise caution when using this host.

</details>

### baud.host
- [Website](https://baud.host)
- baud.host is a low cost hosting provider that is primarily operated by Kybo Group, a Roblox products group.
- baud.host does not allow users to provide their MongoDB Connection URI, this is not recommended as it locks users into a single host, and limits a user's ownership of their data. We were not able to conduct a test on the security of their locally hosted database, but if managed improperly, it could also be a security concern.
- baud.host uses Stripe for payment verification, however, appears to use their own processing flow, instead of the one provided by Stripe. We were unable to conduct a test on security, but this could be a security concern.
- Kybo Group claims compliance with HIPAA, GDPR, DPDPA, with an ISO27001, PCI DSS, SOC 1 Type 2, and SOC 2 Type 2 certifications, however, attempts to verify this have failed. You can conduct your own certification search with the [IAF](https://www.iafcertsearch.org/search/certified-entities?search=Kybo%20Group).
- Some users have reported features in latest updates not working with this host.


{% hint style="danger" %}
### Why These Are Not Recommended
These hosts generally:
Expand Down
6 changes: 0 additions & 6 deletions getting-started.md

This file was deleted.

59 changes: 0 additions & 59 deletions installation-1.md

This file was deleted.

121 changes: 0 additions & 121 deletions installation-continued.md

This file was deleted.

Loading