This is an automated email from the ASF dual-hosted git repository.
yasith pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/airavata.git
The following commit(s) were added to refs/heads/master by this push:
new a7c08d940a docs: Update README files with modern formatting and Java
17 (#507)
a7c08d940a is described below
commit a7c08d940a9a42799df3dbadf881f2f2a853a632
Author: Yasindu Dissanayake <[email protected]>
AuthorDate: Fri Jun 6 04:41:03 2025 +0530
docs: Update README files with modern formatting and Java 17 (#507)
* update readme
* Update README.md
* Update README.md
* Update README.md
* update ide-integration readme
* Addressing changes
* Addressing changes
* Addressing changes
---
README.md | 198 +++++++++++++-------
modules/ide-integration/README.md | 373 +++++++++++++++++++++++---------------
2 files changed, 359 insertions(+), 212 deletions(-)
diff --git a/README.md b/README.md
index 2f25ad38f4..069cea0839 100644
--- a/README.md
+++ b/README.md
@@ -1,108 +1,170 @@
# Apache Airavata
-[](https://travis-ci.org/apache/airavata)
-[](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.apache.airavata%22)
+
-## About
+
+ [](https://travis-ci.org/apache/airavata)
+ [](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.apache.airavata%22)
+
[](https://opensource.org/licenses/Apache-2.0)
+
[](https://github.com/apache/airavata/graphs/contributors)
+</div>
-Apache Airavata is a software framework for executing and managing
computational
-jobs on distributed computing resources including local clusters,
-supercomputers, national grids, academic and commercial clouds. Airavata builds
-on general concepts of service oriented computing, distributed messaging, and
-workflow composition and orchestration. Airavata bundles a server package with
-an API, client software development Kits and a general purpose reference UI
-implementation -
-[Apache Airavata Django
Portal](https://github.com/apache/airavata-django-portal).
+## ๐ About
-Learn more about Airavata at
-[https://airavata.apache.org](https://airavata.apache.org).
+Apache Airavata is a software framework for executing and managing
computational jobs on distributed computing resources including local clusters,
supercomputers, national grids, academic and commercial clouds. Airavata builds
on general concepts of service oriented computing, distributed messaging, and
workflow composition and orchestration. Airavata bundles a server package with
an API, client software development Kits and a general purpose reference UI
implementation.
-## Building Apache Airavata
+**Key Features:**
+- ๐ง Service-oriented architecture with distributed messaging
+- ๐ Workflow composition and orchestration
+- โ๏ธ Multi-cloud and hybrid cloud support
+- ๐ฅ๏ธ Comprehensive API and SDK ecosystem
+- ๐ Reference UI implementation via [Apache Airavata Django
Portal](https://github.com/apache/airavata-django-portal)
-### Prerequisites
+> Learn more at [airavata.apache.org](https://airavata.apache.org)
-- Sources compilation requires Java SDK 11.
-- The project is built with Apache Maven 3+.
-- Set or export JAVA_HOME to point to JDK. For example in Ubuntu:
-`export JAVA_HOME=/usr/lib/jvm/adoptopenjdk-11`
-- Git
+## ๐ Prerequisites
-### Build the distribution
+Before building Apache Airavata, ensure you have:
- git clone https://github.com/apache/airavata.git
- cd airavata
- mvn clean install
+| Requirement | Version | Notes |
+|-------------|---------|-------|
+| **Java SDK** | 17+ | Set `JAVA_HOME` environment variable |
+| **Apache Maven** | 3.8+ | Build automation tool |
+| **Git** | Latest | Version control |
-To build without running tests, use `mvn clean install -Dmaven.test.skip=true`.
-The compressed binary distribution is created at
-PROJECT_DIR/modules/distribution/target.
+### ๐ง Environment Setup
-### Build and run docker distribution (Experimental and not recommended for
production deployments)
-
-* This requires docker and docker-compose installed in your system
+**Ubuntu/Debian:**
+```bash
+export JAVA_HOME=/usr/lib/jvm/openjdk-17-jdk
+```
-* Build the source and docker images for each microservice
+**macOS:**
+```bash
+export JAVA_HOME=$(/usr/libexec/java_home -v 17)
```
- git clone https://github.com/apache/airavata.git
- cd airavata
- mvn clean install
- mvn docker:build -pl modules/distribution
+
+**Windows:**
+```powershell
+set JAVA_HOME=C:\Program Files\OpenJDK\openjdk-17
```
-* Start supporting services and Airavata miroservices (API Server, Helix
Components and the Job Monitors)
+
+## ๐๏ธ Building from Source
+
+### Quick Start
+
+```bash
+# Clone the repository
+git clone [email protected]:apache/airavata.git
+cd airavata
+
+# Build with tests
+mvn clean install
+
+# Build without tests (faster)
+mvn clean install -DskipTests
+
+# Find your distribution
+ls -la modules/distribution/target/
```
- docker-compose -f
modules/ide-integration/src/main/containers/docker-compose.yml -f
modules/distribution/src/main/docker/docker-compose.yml up
+
+### ๐ณ Docker Development (Experimental)
+
+> โ ๏ธ **Note:** Docker deployment is experimental and not recommended for
production use.
+
+**Prerequisites:**
+- Docker Engine 20.10+
+- Docker Compose 2.0+
+
+**Build and Deploy:**
+
+```bash
+# 1. Build source and Docker images
+git clone https://github.com/apache/airavata.git
+cd airavata
+mvn clean install
+mvn docker:build -pl modules/distribution
+
+# 2. Start all services
+##Start all supporting services and Airavata microservices (API Server, Helix
components, and Job Monitors)
+
+docker-compose \
+ -f modules/ide-integration/src/main/containers/docker-compose.yml \
+ -f modules/distribution/src/main/docker/docker-compose.yml \
+ up -d
+
+# 3. Verify services are running
+docker-compose ps
```
-* Django portal and PGA Portal can be pointed to airavata.host:8930 (API) ,
airavata.host:8962 (Profile Service), airavata.host:8443 (Keycloak).
-Make sure that you add a host entry that maps airavata.host -> 127.0.0.1
+**Service Endpoints:**
+- **API Server:** `airavata.host:8960`
+- **Profile Service:** `airavata.host:8962`
+- **Keycloak:** `airavata.host:8443`
-* To stop all the services
+**Host Configuration:**
+Add to your `/etc/hosts` file:
+```
+127.0.0.1 airavata.host
```
- docker-compose -f
modules/ide-integration/src/main/containers/docker-compose.yml -f
modules/distribution/src/main/docker/docker-compose.yml down
+
+**Stop Services:**
+```bash
+docker-compose \
+ -f modules/ide-integration/src/main/containers/docker-compose.yml \
+ -f modules/distribution/src/main/docker/docker-compose.yml \
+ down
```
-* If you do any code change and need to reflect them in the deployment, stop
the docker deployment, rebuild docker images and start the docker deployment
-
-
-## Getting Started
+## ๐ Getting Started
-The easiest way to get started with running Airavata locally and setting up a
-development environment is to follow the instructions in the
-[ide-integration README](./modules/ide-integration/README.md). Those
-instructions will guide you on setting up a development environment with
-IntelliJ IDEA.
+The easiest way to get started with running Airavata locally and setting up a
development environment is to follow the instructions in the [ide-integration
README](./modules/ide-integration/README.md).Those instructions will guide you
on setting up a development environment with IntelliJ IDEA.
-## Contact
+## ๐ค Contributing
-For additional information about Apache Airavata, please contact the user or
dev
-mailing lists: https://airavata.apache.org/mailing-list.html
+We welcome contributions from the community! Here's how you can help:
-## Contributing
+1. **๐ด Fork the repository**
+2. **๐ฟ Create a feature branch**
+3. **โจ Make your changes**
+4. **๐งช Add tests if applicable**
+5. **๐ Submit a pull request**
-Want to help contribute to the development of Apache Airavata? Check out our
-[contributing documentation](http://airavata.apache.org/get-involved.html).
+**Learn More:**
+- [Contributing Guidelines](http://airavata.apache.org/get-involved.html)
+- [Code of Conduct](https://www.apache.org/foundation/policies/conduct.html)
+- [Developer Resources](https://cwiki.apache.org/confluence/display/AIRAVATA)
-## Links
+## ๐ฌ Community & Support
-- [Documentation](https://docs.airavata.org/en/master/)
-- Developer [wiki](https://cwiki.apache.org/confluence/display/AIRAVATA)
-- [Issue Tracker](https://issues.apache.org/jira/projects/AIRAVATA)
+**Get Help:**
+- ๐ง **User Mailing List:**
[[email protected]](mailto:[email protected])
+- ๐จโ๐ป **Developer Mailing List:**
[[email protected]](mailto:[email protected])
+- ๐ **All Mailing Lists:**
[airavata.apache.org/mailing-list](https://airavata.apache.org/mailing-list.html)
-## License
+## ๐ License
+```
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
-additional information regarding copyright ownership. The ASF licenses this
file
-to you under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at
+additional information regarding copyright ownership.
+
+The ASF licenses this file to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance with the License.
+You may obtain a copy of the License at:
-http://www.apache.org/licenses/LICENSE-2.0
+ http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.
+```
+
+See the [LICENSE](LICENSE) file for complete license details.
+
+---
-Please see the [LICENSE](LICENSE) file included in the root directory of the
-source tree for extended license details.
+<div align="center">
+ <strong>Made with โค๏ธ by the Apache Airavata Community</strong>
+</div>
diff --git a/modules/ide-integration/README.md
b/modules/ide-integration/README.md
index e31cd62d2f..1c72fe9e73 100644
--- a/modules/ide-integration/README.md
+++ b/modules/ide-integration/README.md
@@ -1,209 +1,294 @@
-## Introduction
+# Apache Airavata - IDE Integration Setup
-Using this module, you can setup a full Airavata installation inside Intelij
IDEA for development purposes
+<div align="center">
+ <h3>๐ Complete Development Environment Setup for IntelliJ IDEA</h3>
+ <p>Set up a full Airavata installation inside IntelliJ IDEA for seamless
development</p>
+</div>
-## Prerequisites
+---
-* Docker installed with 'docker-compose' utility
- https://docs.docker.com/compose/
+## ๐ Prerequisites
-* InteliJ IDEA with Java 8 installed
- https://www.jetbrains.com/idea/download/#section=mac
+Before starting, ensure you have the following installed on your system:
-* Maven
+| Tool | Version | Purpose | Installation Link |
+|------|---------|---------|-------------------|
+| ๐ณ **Docker & Docker Compose** | Latest | Container orchestration | [Get
Docker](https://docs.docker.com/compose/) |
+| ๐ก **IntelliJ IDEA** | Latest | IDE with Java 17+ | [Download
IDEA](https://www.jetbrains.com/idea/download/) |
+| โ **Java JDK** | 17+ | Runtime environment | [OpenJDK
17](https://openjdk.org/projects/jdk/17/) |
+| ๐ง **Apache Maven** | 3.8+ | Build tool | [Install
Maven](https://maven.apache.org/install.html) |
+| ๐ **Git** | Latest | Version control | [Install
Git](https://git-scm.com/downloads) |
+| ๐ **Python** | 3.8+ | Django portal |
[Python.org](https://www.python.org/downloads/) |
+| ๐ฆ **Node.js & npm** | Latest LTS | Frontend build tools |
[Node.js](https://nodejs.org/) |
-* Git
+## ๐๏ธ Development Environment Setup
-* python3
+### 1๏ธโฃ Clone and Prepare Repository
-* npm (install or update to latest version)
- https://www.npmjs.com/get-npm
+```bash
+# Clone the main repository
+git clone https://github.com/apache/airavata.git
+cd airavata
-## Steps
+# Build the project (this may take a few minutes)
+mvn clean install -DskipTests
+```
-### Setting up the development environment
+### 2๏ธโฃ Open in IntelliJ IDEA
-* Clone Airavata repository to a local directory
+1. **Launch IntelliJ IDEA**
+2. **Open Project** โ Navigate to your cloned `airavata` directory
+3. **Navigate to:** `modules` โ `ide-integration` module
- ```
- git clone https://github.com/apache/airavata
- ```
+## ๐ณ Backend Services Setup
-* Checkout develop branch
+### 3๏ธโฃ Configure Host Resolution
- ```
- git checkout develop
- ```
-* Build the develop branch using Maven
+Add the following entry to your system's hosts file:
- ```
- mvn clean install -DskipTests
- ```
-* Open the project using InteliJ IDEA
+**Linux/macOS:** `/etc/hosts`
+**Windows:** `C:\Windows\System32\drivers\etc\hosts`
-* Browse to modules -> ide-integration module
+```bash
+127.0.0.1 airavata.host
+```
-### Starting backend components (Database, Keycloak, Kafka, RabbitMQ, SSHD
Server)
+### 4๏ธโฃ Start Backend Services
-* Add a host entry to /etc/hosts file in local machine
+Navigate to the containers directory and start all required services:
- ```
- 127.0.0.1 airavata.host
- ```
+```bash
+cd modules/ide-integration/src/main/containers
+docker-compose up -d
+```
-* Go to src/main/containers directory and run
+**Services Started:**
+- ๐๏ธ **MySQL Database**
+- ๐ **Keycloak** (Authentication)
+- ๐จ **Apache Kafka** (Messaging)
+- ๐ฐ **RabbitMQ** (Message Queue)
+- ๐ **SSHD Server** (Secure connections)
- ```
- docker-compose up
- ```
+### 5๏ธโฃ Initialize Database
-* Apply any database migrations. Go to src/main/containers directory and run
+Apply database migrations:
- ```
- cat ./database_scripts/init/*-migrations.sql | docker exec -i
containers-db-1 mysql -p123456
- ```
+```bash
+cd modules/ide-integration/src/main/containers
+cat ./database_scripts/init/*-migrations.sql | docker exec -i containers-db-1
mysql -p123456
+```
-* Wait until all the services come up. This will initialize all utilities
required to start Airavata server
+## ๐ฅ๏ธ Starting Airavata Components
-### Starting API Server
+### 6๏ธโฃ Start API Server
-#### Note: For JDK 11+
-you have to add ``--add-opens java.base/java.lang=ALL-UNNAMED`` as a JVM
argument
+1. **Navigate to:** `org.apache.airavata.ide.integration.APIServerStarter`
+2. **Right-click** in the editor
+3. **Select:** `Run 'APIServerStarter.main()'`
-* Go to org.apache.airavata.ide.integration.APIServerStarter class and right
click on the editor and click Run option. This will start Airavata server
+> ๐ก **JDK 17+ Note:** Add this JVM argument in your run configuration:
+> ```
+> --add-opens java.base/java.lang=ALL-UNNAMED
+> ```
-### Starting Job Execution Engine
+### 7๏ธโฃ Start Job Execution Engine
-* Go to org.apache.airavata.ide.integration.JobEngineStarter class and right
click on the editor and click Run option.
-This will start all components of Job Execution Engine including Helix
Controller, Helix Participant, Pre Workflow Manager and
-Post Workflow Manager
+1. **Navigate to:** `org.apache.airavata.ide.integration.JobEngineStarter`
+2. **Right-click** and select **Run**
-### Starting Job Monitoring components
+**Components Started:**
+- ๐ Helix Controller
+- ๐ฅ Helix Participant
+- โ๏ธ Pre Workflow Manager
+- ๐ Post Workflow Manager
-* This will start the Email Based Job Monitoring agent. Before starting this,
you have to create a new gmail account by going to
-https://accounts.google.com/signup
+### 8๏ธโฃ Start Job Monitoring
-* Once the account is created, turn on 2-Step Verification and create an App
Password (Use the type "Other" from the App type selection and give the name as
"Airavata")
-https://myaccount.google.com/security
+#### **Setup Email Monitor (One-Time Setup)**
-* Update the email address and App Password in
src/main/resources/airavata-server.properties file
+1. **Create a Gmail Account**
[https://accounts.google.com/signup](https://accounts.google.com/signup)
- email.based.monitor.address=CHANGEME
- email.based.monitor.password=CHANGEME
-
-* Go to org.apache.airavata.ide.integration.JobMonitorStarter class and right
click on the editor and click Run option.
+2. **Enable 2-Step Verification**
[https://myaccount.google.com/security](https://myaccount.google.com/security)
-### Starting User Portal (Django Portal)
+3. **Go to App Passwords**
[https://myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords)
+ *(Make sure you're logged in and have already enabled 2-Step Verification.)*
-* You can create and launch experiments and manage credentials using this
portal
+4. **Generate App Password:**
+ - Enter the name **"Airavata"** and click **"Generate"**.
-* This is a separate project so you need to clone this in to a new directory
outside the Airavata code base
-
- ```
- git clone https://github.com/apache/airavata-django-portal
- ```
-
-* Go to airavata-django-portal directory and run
+5. **Copy the Generated App Password**
+ - A 16 character password will appear **copy and save it immediately**, as
it will not be shown again.
- ```
- python3 -m venv venv
- source venv/bin/activate
- pip install -r requirements.txt
- ```
-* Create a local settings file. Copy
- `django_airavata/settings_local.py.ide` to
- `django_airavata/settings_local.py`
+5. **Update Configuration:**
+ Edit `src/main/resources/airavata-server.properties`:
+ ```properties
+ [email protected]
+ email.based.monitor.password=your-app-password
+ ```
-* Run Django migrations
+6. **Start Monitor:**
+ - Navigate to: `org.apache.airavata.ide.integration.JobMonitorStarter`
+ - Right-click and **Run**
- ```
- python3 manage.py migrate
- ```
+## ๐ User Portal Setup (Django)
-* Build the JavaScript sources. There are a few JavaScript packages in the
source tree, colocated with the Django apps in which they are used. The
`build_js.sh` script will build them all.
+### 9๏ธโฃ Django Portal Installation
- ```
- ./build_js.sh
- ```
+**You can create and launch experiments and manage credentials using this
portal.**
-* Load the default Wagtail CMS pages.
+```bash
+# Navigate outside the Airavata directory
+cd ..
- ```
- python3 manage.py load_default_gateway
- ```
+# Clone the Django portal repository
+git clone https://github.com/apache/airavata-django-portal.git
+cd airavata-django-portal
-* Run the server
+# Create a virtual environment
+python3 -m venv venv
- ```
- python3 manage.py runserver
- ```
-
-* Point your browser to http://localhost:8000/auth/login. Use user name :
default-admin and password : 123456
+# Activate the virtual environment
+source venv/bin/activate # For Windows: venv\Scripts\activate
-### Optional: Starting Super Admin Portal (PGA)
+# Install Python dependencies
+pip install -r requirements.txt
-* This portal is required when you are going to register new compute resources
or storage resources into the gateway
+### ๐ Configure Django Portal
-* Go to src/main/containers/pga directory and run
+```bash
+# Create local settings
+cp django_airavata/settings_local.py.ide django_airavata/settings_local.py
- ```
- docker-compose up -d
- ```
+# Run database migrations
+python3 manage.py migrate
-* Run following command to get the ip address of host machine
+# Build JavaScript components
+./build_js.sh
- For Mac OSX
+# Load default CMS pages
+python3 manage.py load_default_gateway
- ```
- docker-compose exec pga getent hosts docker.for.mac.host.internal | awk '{
print $1 }'
- ```
-
- For Windows
-
- ```
- docker-compose exec pga getent hosts host.docker.internal
- ```
+# Start development server
+python3 manage.py runserver
+```
-* Update the host entries of pga container with above ip address
+### ๐ Access User Portal
- ```
- docker-compose exec pga /bin/sh -c "echo '<host-machine ip> airavata.host'
>> /etc/hosts"
- ```
+- **URL:** [http://localhost:8000/auth/login](http://localhost:8000/auth/login)
+- **Username:** `default-admin`
+- **Password:** `123456`
-* Now PGA should be accessible through http://airavata.host:8008
+## ๐ ๏ธ Admin Portal Setup (Optional)
-* Use the username : default-admin and password : 123456 to login to the portal
+For registering compute resources and storage resources:
-### Stop all components
+### 1๏ธโฃ Starting Super Admin Portal (PGA)
-* For each composer file, run following commands to cleanup docker spawned
components
+**This portal is required when registering new compute or storage resources
into the gateway.**
- ```
- docker-compose down
- ```
-
- ```
- docker-compose rm
- ```
-
-### NOTE: (Optional) Creating certificates if expired
-
- * This is required only when the self signed certificate for keycloak is
expired
- * Go to <PROJECT_ROOT>/keystores
- * Provide password as airavata for all key stores
+```bash
+cd modules/ide-integration/src/main/containers/pga
+docker-compose up -d
+```
- ```sh
+### 2๏ธโฃ Configure Host Resolution
- # Remove existing key stores
- rm -f airavata.jks client_truststore.jks
+**Get host machine IP:**
- # Generate a PKCS12 keystore with a self-signed certificate
- keytool -genkey -keyalg RSA -alias selfsigned -keystore airavata.jks
-storetype pkcs12 -storepass airavata -validity 360 -keysize 2048 \
- -dname "CN=airavata.host, OU=airavata.host, O=airavata.host,
L=airavata.host, ST=airavata.host, C=airavata.host"
+**macOS:**
+```bash
+docker-compose exec pga getent hosts docker.for.mac.host.internal | awk '{
print $1 }'
+```
- # Also generate a JKS keystore with that certificate (for
backward-compatibility)
- keytool -importkeystore -noprompt \
- -srckeystore airavata.jks -srcstoretype pkcs12 -srcstorepass airavata \
- -destkeystore client_truststore.jks -deststoretype jks -deststorepass
airavata
+**Windows:**
+```bash
+docker-compose exec pga getent hosts host.docker.internal
+```
- ```
+**Update container hosts:**
+*Replace <host-machine-ip> with the actual IP*
+```bash
+docker-compose exec pga /bin/sh -c "echo '<host-machine-ip> airavata.host' >>
/etc/hosts"
+```
+
+### 3๏ธโฃ Access Admin Portal
+
+- **URL:** [http://airavata.host:8008](http://airavata.host:8008)
+- **Username:** `default-admin`
+- **Password:** `123456`
+
+## ๐ Cleanup & Troubleshooting
+
+### Stop All Services
+
+```bash
+# In each docker-compose directory, run:
+docker-compose down
+docker-compose rm -f
+
+# Remove unused containers and networks
+docker system prune
+```
+
+### ๐ Certificate Renewal (If Expired)
+
+Only needed when Keycloak certificates expire:
+
+```bash
+cd modules/ide-integration/src/main/resources/keystores
+
+# Remove old keystores
+rm airavata.jks client_truststore.jks
+
+# Generate new keystores
+# airavata.jks (PKCS12, preferred)
+keytool -genkey -keyalg RSA -alias selfsigned -keystore airavata.jks \
+ -storetype pkcs12 -storepass airavata -validity 360 -keysize 2048 \
+ -dname
"CN=airavata.host,OU=airavata.host,O=airavata.host,L=airavata.host,ST=airavata.host,C=airavata.host"
+# client_truststore.jks (JKS, legacy)
+keytool -importkeystore -noprompt \
+ -srckeystore airavata.jks -srcstoretype pkcs12 -srcstorepass airavata \
+ -destkeystore client_truststore.jks -deststoretype jks -deststorepass
airavata
+```
+
+## ๐ Service Status Overview
+
+| Service | Port | Status Check | Purpose |
+|---------|------|-------------|---------|
+| ๐๏ธ **MySQL** | 3306 | `docker ps` | Database |
+| ๐ **Keycloak** | 8443 | [airavata.host:8443](http://airavata.host:8443) |
Authentication |
+| ๐จ **Kafka** | 9092 | Internal | Messaging |
+| ๐ฐ **RabbitMQ** | 5672 | Internal | Message Queue |
+| ๐ **Django Portal** | 8000 | [localhost:8000](http://localhost:8000) | User
Interface |
+| ๐ ๏ธ **PGA Admin** | 8008 | [airavata.host:8008](http://airavata.host:8008) |
Admin Portal |
+
+## ๐ Common Issues
+
+**Port Conflicts:**
+```bash
+# Check what's using a port
+lsof -i :8000
+netstat -tulpn | grep :8000
+```
+
+**Docker Issues:**
+```bash
+# Reset Docker
+docker system prune -a
+docker-compose down --volumes
+```
+
+**Build Failures:**
+```bash
+# Clean Maven cache
+mvn clean
+rm -rf ~/.m2/repository/org/apache/airavata
+```
+
+---
+
+<div align="center">
+ <strong>๐ Happy Developing with Apache Airavata!</strong>
+ <br>
+ <em>Need help? Check our <a
href="https://airavata.apache.org/mailing-list.html";>mailing lists</a></em>
+</div>
\ No newline at end of file
