Modmail Docs
GitHubDonateSetupDiscord Server
  • Introduction
  • Installation
    • Local hosting / VPS
      • Windows
      • MacOS
      • Docker
      • Ubuntu
      • Debian
      • Fedora
      • Alma Linux
      • Logviewer
      • Patreon logviewer
    • Railway
    • Heroku
    • Community Guides
  • Setting up auto-restart
  • Updating
  • Getting Started
  • Usage
    • Plugins
    • Configuration
    • Permissions
  • Frequently Asked Questions
  • OLD DOCS
    • Installation
    • Installation (continued)
    • Color Names
    • Configuration Variables (Config Vars)
    • Configure Modmail and Logviewer
    • Frequently Asked Questions
    • Modmail Usage
    • Updating
    • Video Tutorials
Powered by GitBook
On this page
  • Prerequisites
  • Dependencies
  • Installing Bot

Was this helpful?

Edit on GitHub
  1. Installation
  2. Local hosting / VPS

Windows

Deploy Modmail on a Windows machine.

PreviousLocal hosting / VPSNextMacOS

Last updated 1 year ago

Was this helpful?

Prerequisites

  1. Minimum 2GB of RAM*

  2. At least 2GB available disk space.

  3. Supported Windows version:

    • Windows 10

    • Windows 11

Note that while it is possible to run Modmail with even less memory, Windows 10 itself recommend at least 2GB (4GB for Windows 11). This guide assumes the lowest threshold to comfortably run Modmail without possibly running into any resource bottleneck.

It is not recommended to run Modmail with previous versions of Windows such as Windows 7 or Windows 8.1 as they no longer receive important security updates, making your hosted applications significantly more prone to security vulnerabilities.

Dependencies

We will be using the following dependencies:

  • Chocolatey

  • Python 3.10

  • Additional Modmail requirements:

To install these dependencies, we will be using Powershell.

Search “powershell” in the Windows start menu, right-click on it and then click “Run as administrator”.

Then run each of the following commands:

Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
choco upgrade git --params "/GitOnlyOnPath /WindowsTerminal" -y
choco upgrade python310 -y

After that, ensure pip and pipenv are installed and updated for Python 3.10 with:

py -3.10 -m ensurepip --upgrade
py -3.10 -m pip install pipenv

Installing Bot

In any folder location of your choice, Shift+Right Click and click on Open PowerShell window here.

In your PowerShell window, run these commands to clone the official Modmail repository locally and cd into the folder:

git clone https://github.com/modmail-dev/modmail
cd modmail

Install project dependencies inside Modmail's pipenv with:

py -3.10 -m pipenv install

Lastly, in your PowerShell window simply enter the command below to run your Modmail bot:

py -3.10 -m pipenv run bot

If no error shows up, it means that your Modmail is now running correctly.

After the above installation has finished, download and install the GTK runtime for Windows by .

Create a new file in the modmail folder named .env and paste in your environmental variables needed to run Modmail. Refer to the steps in the to find where to obtain these.

GTK for Windows
clicking here
parent Installation page