This document outlines the steps required to set up and run the project locally.
The following diagram illustrates the project's architecture:
This image displays the high-level architecture of the project.
- Git: Ensure Git is installed on your system.
- Node.js and npm: Node.js and npm are required for dependency management and running scripts.
- Docker: Docker must be installed and configured. It is highly recommended to configure Docker to run without
sudoprivileges. If you haven't done so, please follow this tutorial: How to Run Docker Commands Without Sudo.
-
Clone the Repository:
git clone https://github.com/sidharthtripathi/netlify
-
Navigate to the Cloned Directory:
cd netlify -
Install Dependencies:
npm install
This command installs all necessary dependencies defined in the
package.jsonfile. -
Build Docker Container:
npm run build:container
This script builds the necessary Docker containers for the project. Ensure Docker is running and accessible.
-
Configure Environment Variables:
The project utilizes environment variables for configuration. Each workspace within the
appsdirectory (webserver,s3-proxy, andbuilder) requires specific environment variables.- Navigate to each workspace's directory (
apps/webserver,apps/s3-proxy,apps/builder). - Copy the
.env.examplefile to.envin each respective workspace. - Modify the
.envfiles with the appropriate values for your environment.
- Navigate to each workspace's directory (
-
Start the Development Environment:
From the root directory of the project, execute the following command:
npm run dev
This command starts the development server, which will launch the application in development mode.
