Technologies Used

• ExpressJs
• Mongoose
• Typegoose
• TypeScript
• Passport

Features

• Admin dashboard
• User settings and or user dashboard
• Send emails
• Receive emails
• Connections through other parties ie discord, twitter, facebook etc..

Run locally

You can setup the application on your local system by 2 methods

• Docker
• Manually

:warning: If you are using unix operating system than prefix all bash commands with sudo

Create new directory and clone the repository

mkdir multi-email
cd multi-email
git clone https://github.com/MultiEmail/backend.git
cd backend

Using Docker

Prerequisite

• Docker is installed on your local system
• .env file wih all required variables (check environment variables mentioned below)

Run Server

docker compose --env-file ./.env up

To rebuild the image

docker compose --env-file ./.env up --build

Create admin user

List current running docker containers

docker ps

Output

CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS          PORTS                                         NAMES
d07f06c78445   backend-api    "docker-entrypoint.s…"   46 minutes ago   Up 46 minutes   0.0.0.0:3001->3001/tcp, :::3001->3001/tcp     Server
91826c111b76   mongo:latest   "docker-entrypoint.s…"   52 minutes ago   Up 46 minutes   0.0.0.0:2717->27017/tcp, :::2717->27017/tcp   Database

now copy the CONTAINER ID of image/container backend-api and replace <container_id> in the below mentioned commands and execute them

# build and install the command line tool in docker container
docker exec <container_id> yarn build
docker exec <container_id> npm i -g .

# create new admin user in database in docker container
docker exec <container_id> multi-email-admin -e <email> -u <username> -p <password>

Extra's (Port forwarding for docker containers)

if you want to access database inside docker container from host than use

mongosh --port 2717

or if you want to use mongodb compass than you can use this connection string

mongodb://localhost:2717/

Manually

Prerequisite

• Latest Node js version
• Yarn installed
• Mongodb installed on local system
• .env file wih all required variables (check environment variables mentioned below)

Install all the required dependencies

this project use Yarn as package manager

yarn install

Run the server

yarn dev

Create admin user

yarn build
npm i -g .
multi-email-admin -e <email> -u <username> -p <password>

Environment Variables

To run this project, you will need to add the following environment variables to your .env file

NOTEs

• Your DB_URI must be mongodb://mongo_db:27017/multiemail if you are using docker
• If you use gmail account as EMAIL_ID than you must enable 2FA for your google account and generate app password and use it as EMAIL_PASS

Resources for generating .env variables

• You can get google credentials by following this guide
• You can use crypto tools for generating RSA keys for access and refresh tokens
• RSA keys must be 1024

Detailed docs

• Github Pages
• Wiki

Wanna join the team?

• Discord server
• Postman team

Contributing

• Contributions make the open source community such an amazing place to learn, inspire, and create.
• Any contributions you make are truly appreciated.
• Check out our contribution guidelines for more information.

License

This project is Licensed under the MIT License. Please go through the License atleast once before making your contribution.

Contributors ✨

Thanks goes to these wonderful people ❤:

Ayush Chugh 🐛 🤔 🧑‍🏫 🛡️ 💻 🚧 📆 👀	Toby 💻 👀 🚧	shivam vishwakarma 📖 💻	Tharun K 📖 💻 🚇	Ayush 🐛 🛡️ 🤔 🧑‍🏫 💻 🚧 📆 👀	James 💵 🤔 💼	AndrewDev 🤔
Arpit Chugh 📖	Drishit Mitra 💻	João Mota 💻	Shashank Bhat G S 📖	Alberto Herrera Vargas 💻	Vadym Yatsyuk 💻	Toby 🐛 🛡️ 🤔
yash jain 💻	Bongani Gumbo 📖	Shikhar 💻
Add your contributions

This project follows the all-contributors specification. Contributions of any kind welcome!