Fomalhaut-core

From TEIDESAT Project and Hyperspace Canarias

Description

This software serves as the backend application and database service for the TEIDESAT Project's mission control web application. It runs a Spring Boot reactive web API with a MongoDB instance.

Prerequisites

Before running the application, ensure you have installed the following:

• Java JDK 17+
• Maven 3+
• Docker and Docker Compose

Installation

1. Clone the repository:

   git clone https://github.com/your-user/your-repository.git
   cd your-repository

2. Environment variables are pre-configured in application.properties:

   spring.data.mongodb.uri=mongodb://fomalhaut-mongodb:27017/
   server.port=8081

Running the Project

Start backend and MongoDB using Docker

To run the project with Docker simply run the following command:

docker compose up

Note: The first time you may need to create the docker network to allow the backend to comunicate with the database, you can do this by running the following command:

docker network create fomalhaut-core-network

Verification

Once the application is running, you can access the API at:

http://localhost:8081

Stopping the Application

• Database: docker compose down
• Application: Press CTRL + C in the Maven terminal

Troubleshooting

• If port 8081 is in use, you can change it in application.properties
• To clean up MongoDB containers and volumes:

  docker compose down -v