How to Install Monica on Windows 10

Monica is an open-source Personal Relationship Management (PRM) tool that allows you to track and manage personal interactions with friends, family, and other contacts. This tutorial will guide you through the process of installing Monica on Windows 10.

Prerequisites

Before we get started, ensure that your system meets the following requirements:

• Windows 10 operating system
• PHP 7.4 or higher
• Composer
• Node.js 14 or higher
• Git

Step 1: Install PHP

To install PHP on Windows 10, follow these steps:

1. Download PHP from the official PHP website.
2. Extract the downloaded ZIP file to a directory (e.g. C:\PHP).
3. Add the PHP directory to your system's PATH environment variable.

Step 2: Install Composer

Composer is a dependency manager for PHP. Here's how you can install it:

1. Download the Composer installer.

2. Open Command Prompt and navigate to the directory where the installer was downloaded.

3. Run the following command:

   php composer-setup.php --install-dir=bin --filename=composer
   

Step 3: Install Node.js

Node.js is required to build Monica's front-end assets. To install Node.js on Windows 10, follow these steps:

1. Download the Node.js installer.
2. Double-click the downloaded MSI file to start the installation process.
3. Follow the steps in the Node.js installer.

Step 4: Install Git

Git is a version control system that you will use to download Monica's source code. To install Git on Windows 10, follow these steps:

1. Download the Git installer.
2. Double-click the downloaded EXE file to start the installation process.
3. Follow the steps in the Git installer.

Step 5: Download Monica

1. Open Command Prompt.

2. Navigate to the directory where you want to install Monica.

3. Run the following command to clone the Monica repository:

   git clone https://github.com/monicahq/monica.git
   

Step 6: Install Dependencies

1. Navigate to the cloned monica directory.

2. Run the following commands to install the required dependencies:

   composer install
   npm install
   

Step 7: Configure the .env File

1. Rename .env.example to .env:

   copy .env.example .env
   

2. Edit the .env file with your database settings:

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=monica
   DB_USERNAME=root
   DB_PASSWORD=
   

   Replace the placeholders with your actual database settings.

Step 8: Generate the App Key

1. Run the following command to generate the Laravel app key:

   php artisan key:generate
   

Step 9: Run the Database Migrations

1. Run the following command to run database migrations:

   php artisan migrate --seed
   

Step 10: Build Front-end Assets

1. Run the following command to build the front-end assets:

   npm run dev
   

Step 11: Start the Server

1. Run the following command to start the server:

   php artisan serve
   

2. Open your web browser and go to http://localhost:8000.

Congratulations! You have successfully installed Monica on your Windows 10 system. You can now log in with the default credentials: email admin@localhost and password secret.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!