Ubuntu
Deploy Modmail on an Ubuntu server.
Last updated
Was this helpful?
Deploy Modmail on an Ubuntu server.
Last updated
Was this helpful?
For safety reasons, DO NOT install Modmail with a root user. A misbehaving or malicious plugin installed on your Modmail bot can easily access your entire system. If you are unsure how to create a new user on Linux, see .
Root access (sudo
).
Minimum 1GB of RAM
At least 2GB available disk space.
Supported releases:
Ubuntu 18.04 LTS (Bionic Beaver)
Ubuntu 20.04 LTS (Focal Fossa)
Ubuntu 22.04 LTS (Jammy Jellyfish)
We will be using the following dependencies:
Python 3.10
Tools: git
, wget
, nano
, software-properties-common
Additional Modmail requirements: libcairo2-dev
, libffi-dev
, g++
To install these dependencies, we will be using apt
.
We recommend adding the deadsnakes
ppa to install Python 3.10:
Now install the pre-requirements with apt
, you can copy and run these 3 lines at once:
After that, install pipenv
with:
Clone and change directory into the Modmail folder with:
Inside the Modmail folder, Install pipenv
and its Python packages with:
After that, press Ctrl+O
and Enter
to save your changes. Exit the nano
editor with Ctrl+X
.
After your .env
file is ready, you can now go ahead and try running your bot with:
If no error shows up, it means your bot is now running correctly. You can stop the bot from running with Ctrl+C
to continue using your terminal.
Create a file named .env
with nano
and paste all the environmental variables (secrets) needed to run the bot via right-clicking in the nano editor. Refer to the steps in the to find where to obtain these.
If using the nano
editor is a bit of a learning curve, you can always FTP into your server using software like to edit the .env
file manually with your preferred GUI-based editor like Notepad.