Lunary Application Setup

This document provides a comprehensive guide to setting up the Lunary application using Docker and Helm charts.

Table of Contents

• Overview
• Getting Started
• Prerequisites
• Step 1: Clone the Lunary Repository
• Step 2: Clone the Lunary-Charts Repository
• Step 3: Build Docker Images
• Step 4: Deploy Using Helm Charts
• License

Overview

The Lunary application is designed for efficient operations with a modern architecture. This guide outlines the steps necessary to set up and run the application locally using Docker and deploy it using Helm charts.

Getting Started

Follow the steps below to clone the Lunary repository, build the Docker images, and run the application.

Prerequisites

Ensure you have the following installed on your machine:

• Docker: Install Docker
• Helm: Install Helm
• Git: Install Git

Step 1: Clone the Lunary Repository

1. Open your terminal.

2. Clone the official Lunary repository using the following command:

   git clone https://github.com/lunary-ai/lunary.git

3. Navigate into the cloned Lunary directory:

   cd lunary

Step 2: Clone the Lunary-Charts Repository

1. In the terminal, clone the Lunary-Charts repository using the following command:

   git clone https://github.com/its-aqeel/lunary-charts.git

2. Navigate into the cloned Lunary-Charts directory:

   cd lunary-charts

Step 3: Build Docker Images

1. Navigate back to the Lunary directory:

   cd ../lunary

2. Use the provided Makefile and Dockerfile from the Lunary-Charts repository to build the Docker images. Run the following commands:

   cp ../lunary-charts/Makefile Makefile
   cp ../lunary-charts/Dockerfile Dockerfile
   make

   This command will execute the default target defined in the Makefile, which builds both the backend and frontend Docker images.

3. After the build process completes, verify that the images have been created by running:

   docker images

   You should see images for both the backend and frontend in the list.

Step 4: Deploy Using Helm Charts

1. Navigate back to the Lunary-Charts directory:

   cd ../lunary-charts/deployment

2. Ensure you have the Helm charts set up in your repository. Use the following command to install the charts:

   helm install lunary-app lunary-app 

3. To customize the deployment, you can modify the values.yaml file in your Helm chart directory. This file contains configurable parameters for your application, such as environment variables, service types, and replica counts.