Overview Before installing Masar Eagle, ensure your system meets the following requirements. This guide covers all necessary software, hardware specifications, and dependencies needed to run Masar Eagle successfully.
System Requirements Hardware Requirements
Development Environment
CPU : 4+ cores recommendedRAM : 8GB minimum, 16GB recommendedStorage : 20GB free spaceNetwork : Stable internet connection
Production Environment
CPU : 8+ cores recommendedRAM : 16GB minimum, 32GB+ recommendedStorage : 100GB+ SSD storageNetwork : High-bandwidth connection Operating System
Ubuntu 20.04 LTS or later
Debian 11 or later
CentOS 8 or later
Any modern Linux distribution with Docker support
Windows 10/11 with WSL2
Windows Server 2019 or later
Docker Desktop for Windows
macOS 11 (Big Sur) or later
Docker Desktop for Mac
Required Software .NET SDK
Install .NET 10.0 SDK
Masar Eagle requires .NET SDK version 10.0.100-rc.1.25451.107 or later. # Download and install .NET 10.0 SDK wget https://dotnet.microsoft.com/download/dotnet/10.0 # Verify installation dotnet --version # Expected output: 10.0.100-rc.1.25451.107 or later
The project uses preview releases with rollForward: latestPatch and allowPrerelease: true configured in global.json.
Verify SDK Installation
You should see .NET 10.0.100-rc.1 or later in the output. Docker
Install Docker Engine
Docker is required for containerization and orchestration. # Ubuntu/Debian curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh # Start Docker service sudo systemctl start docker sudo systemctl enable docker
Install Docker Compose
# Docker Compose v2 (comes with Docker Desktop) docker compose version # If not available, install manually sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$( uname -s )-$( uname -m )" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose
Verify Docker Installation
docker --version docker compose version # Test Docker docker run hello-world
Ensure your user has permission to run Docker commands. On Linux, add your user to the docker group: sudo usermod -aG docker $USER newgrp docker
PostgreSQL
Version Requirements
PostgreSQL 14+ is requiredPostgreSQL 15 or 16 is recommended for production
Installation Options
Docker (Recommended)
Native Installation
PostgreSQL will be automatically provisioned via .NET Aspire: # No manual installation needed # Aspire will create PostgreSQL containers automatically
The AppHost configuration includes:
PostgreSQL server with pgAdmin on port 5050
Automatic database creation for all services
Data persistence with Docker volumes
# Ubuntu/Debian sudo apt update sudo apt install postgresql postgresql-contrib # Start PostgreSQL sudo systemctl start postgresql sudo systemctl enable postgresql
# Using Homebrew brew install postgresql@16 brew services start postgresql@16
RabbitMQ
Version Requirements
RabbitMQ 3.12+ is requiredManagement plugin should be enabled
Installation
Docker (Recommended)
Native Installation
RabbitMQ will be automatically provisioned via .NET Aspire: # Aspire configuration includes: # - RabbitMQ with management plugin # - Default credentials: guest/guest # - Management UI available
# Ubuntu/Debian sudo apt install rabbitmq-server # Enable management plugin sudo rabbitmq-plugins enable rabbitmq_management # Start RabbitMQ sudo systemctl start rabbitmq-server sudo systemctl enable rabbitmq-server
Database Setup Database Requirements Masar Eagle uses multiple PostgreSQL databases:
User Database Stores user profiles, drivers, passengers, and companies
Trip Database Manages trips, bookings, and wallet transactions
Notifications Database Handles notifications and device tokens
Auth Database Manages authentication with OpenIddict
When using .NET Aspire, these databases are created automatically. Manual creation is only needed for native PostgreSQL installations.
Optional Dependencies
Visual Studio 2022 (17.8 or later) - WindowsVisual Studio Code with C# extension - All platformsJetBrains Rider - All platforms
# Verify Git installation git --version # Install if needed sudo apt install git # Linux brew install git # macOS
Required for frontend development if working with Aspire dashboard customizations: # Install Node.js 18+ curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install nodejs
The following are automatically provisioned via .NET Aspire:
Prometheus (v3.2.1) - Metrics collectionGrafana - Metrics visualizationJaeger - Distributed tracingLoki - Log aggregationOpenTelemetry Collector - Telemetry pipeline
Key Dependencies Core Packages Aspire
Database
Messaging
Authentication
Aspire.Hosting.AppHost: 13.0.2 Aspire.Hosting.PostgreSQL: 13.0.2 Aspire.Hosting.RabbitMQ: 13.0.2 Aspire.Hosting.Yarp: 13.0.2
Npgsql: 10.0.0 linq2db: 5.4.0 FluentMigrator: 7.1.0 EntityFrameworkCore: 10.0.0 (Identity only)
WolverineFx: 5.0.0 WolverineFx.RabbitMQ: 5.0.0 WolverineFx.Postgresql: 5.0.0
OpenIddict: 6.2.0 OpenIddict.AspNetCore: 6.2.0 OpenIddict.EntityFrameworkCore: 6.2.0 JWT Bearer: 10.0.0-preview.1.25120.3
Network Requirements Ports Ensure the following ports are available:
Service Port Description Gateway 8080 API Gateway (YARP) Identity 8080 Identity Service Users 8080 Users Service Trips 8080 Trips Service Notifications 8080 Notifications Service PostgreSQL 5432 Database Server pgAdmin 5050 PostgreSQL Admin UI RabbitMQ 5672 AMQP Protocol RabbitMQ Mgmt 15672 Management UI Aspire Dashboard 8080 Orchestration Dashboard Prometheus 9090 Metrics Grafana 3000 Visualization Jaeger 16686 Tracing UI Loki 3100 Logs
If any ports are already in use, modify the port mappings in AppHost.cs before running the application.
Verification Run the following commands to verify all prerequisites are met:
#!/bin/bash echo "Checking prerequisites..." # Check .NET SDK if command -v dotnet & > /dev/null; then echo "✓ .NET SDK: $( dotnet --version )" else echo "✗ .NET SDK not found" fi # Check Docker if command -v docker & > /dev/null; then echo "✓ Docker: $( docker --version )" else echo "✗ Docker not found" fi # Check Docker Compose if docker compose version & > /dev/null; then echo "✓ Docker Compose: $( docker compose version)" else echo "✗ Docker Compose not found" fi # Check Git if command -v git & > /dev/null; then echo "✓ Git: $( git --version )" else echo "✗ Git not found" fi echo "\nPrerequisite check complete!"
Next Steps
Installation Install Masar Eagle on your system
Configuration Configure environment variables and settings