1.8 KiB
Getting started
Welcome to MERNMail! This guide will help you set up and run MERNMail on your local machine. MERNMail is an open-source webmail application built using the MERN stack (MongoDB, Express, React, Node.JS).
Prerequisites
Before you begin, ensure you have the following software and tools installed on your machine:
- Node.JS: Make sure you have Node.JS installed. You can download it from nodejs.org.
- npm: Node Package Manager (npm) comes with Node.JS. Ensure it is installed and up to date.
- MongoDB: Install MongoDB from mongodb.com.
- Git: Install Git from git-scm.com.
Installation
Follow these steps to install and set up MERNMail:
1. Clone the Repository
First, clone the MERNMail repository:
git clone https://git.svrjs.org/mernmail/mernmail.git
cd mernmail
2. Install Dependencies
Navigate to the project directory and install the necessary dependencies:
npm install
3. Configuration
Copy the .env.example
file to a .env
file in the root directory of the project. The configuration options can be found in the /docs/configuration page.
4. Running the Application
Start the MERNMail server:
npm start
5. Accessing the Application
Open your web browser and navigate to http://localhost:3000
to access the MERNMail application.
Next Steps
Now that you have MERNMail up and running, you can explore the following sections of the documentation:
- Configuration: Learn how to configure MERNMail.
- Usage: Understand how to use MERNMail for sending and receiving emails.
- Deployment: Learn how to deploy the MERNMail webmail application.