mernmail-website/docs/getting-started.md
Dorian Niemiec 5698071d47
Some checks failed
Deploy Next.js application / deploy (push) Has been cancelled
docs: add guide on deployment with PM2 + NGINX
2024-11-08 17:20:38 +01:00

1.9 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 and Build the Application

Navigate to the project directory, install the necessary dependencies, and build the MERNMail application:

npm install
npm run build

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 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.