Skip to main content

​
System Requirements

Before installing Med Agenda, ensure your system meets the following requirements:
  • Operating System: Linux, macOS, or Windows
  • Memory: Minimum 2GB RAM (4GB recommended)
  • Disk Space: At least 500MB free space
  • Network: Internet connection for downloading dependencies

​
Prerequisites

Med Agenda requires the following software to be installed:

​
Required

Java 21

Amazon Corretto 21 or any JDK 21 distribution

PostgreSQL

PostgreSQL 12 or higher

​
Optional (for Docker deployment)

Docker

Docker 20.10 or higher

Docker Compose

Docker Compose v2.0 or higher

​
Development Tools

  • Maven 3.9+: For building from source (included via Maven wrapper)
  • Node.js 18+: For frontend development

​
Installation Methods

Med Agenda can be deployed using two methods:

Docker Deployment

Recommended for production. Quick setup with containerization.

Manual Installation

For development or custom deployments.

​
Quick Installation Steps

1

Clone the repository

git clone https://github.com/your-org/med-agenda.git
cd med-agenda/backend/gestaoConsultasMedicas
2

Configure environment variables

Create a .env file with your database and API credentials:
cp .env.example .env
# Edit .env with your configuration
See Environment Variables for details.
3

Build and run with Docker Compose

docker-compose up -d
4

Verify installation

curl http://localhost:8080
You should see “Hello World” response.

​
Manual Installation

1

Install Java 21

brew install openjdk@21
2

Install PostgreSQL

brew install postgresql@15
brew services start postgresql@15
Or use Neon.tech for managed PostgreSQL (recommended).
3

Clone and build the project

git clone https://github.com/your-org/med-agenda.git
cd med-agenda/backend/gestaoConsultasMedicas
./mvnw clean package -DskipTests
4

Configure the application

Set up your environment variables or edit application.properties:
export SPRING_DATASOURCE_URL="jdbc:postgresql://localhost:5432/medagenda"
export SPRING_DATASOURCE_USERNAME="postgres"
export SPRING_DATASOURCE_PASSWORD="your_password"
5

Run the application

java -jar target/gestaoConsultasMedicas-0.0.1-SNAPSHOT.jar

​
Verification

After installation, verify that Med Agenda is running correctly: 
curl http://localhost:8080
# Expected: "Hello World"

​
Next Steps

Docker Deployment

Learn about containerized deployment

Database Setup

Configure PostgreSQL database

Environment Variables

Configure application settings

​
Troubleshooting

Change the server port by setting the SERVER_PORT environment variable:
export SERVER_PORT=8081
Or in Docker Compose, modify the ports mapping in docker-compose.yml.
Verify your database is running and credentials are correct:
# Test PostgreSQL connection
psql -h localhost -U postgres -d medagenda
Check the Database Setup guide for configuration help.
Ensure you’re using Java 21:
java -version
# Should show version 21.x.x

Build docs developers (and LLMs) love

Get started for freeTalk to us