MediNet Installation Step-by-step server and client configuration

Complete guide to install and configure MediNet in your local or production environment. Includes central server setup and hospital client configuration.

Quick Start

Essential steps to get MediNet running

download

1. Download

Clone the repository from GitHub

settings

2. Install

Run the automated installation script

play_arrow

3. Launch

Docker containers start automatically

System Requirements

Minimum and recommended specifications

computer

Operating System

check_circle Windows 10/11
check_circle macOS 10.15+
check_circle Linux (Ubuntu 18.04+)
code

Required Software

check_circle Docker Desktop
check_circle Docker Compose
check_circle Git

Don't have Docker?

Windows/Mac: Download Docker Desktop

Linux: Install Docker Engine

memory

Minimum Hardware

check_circle 4 GB RAM (8 GB recommended)
check_circle 2 GB free space
check_circle Stable internet connection
dns

Client Installation

MediNet client configuration

1

Download the Code

Clone the official MediNet Client repository from GitHub:

terminal Terminal/CMD
git clone https://github.com/isglobal-brge/MediNetClient
cd medinet
2

Run Installation Script

Execute the automated installation script that will set up Docker containers and start all services:

terminal Terminal/CMD
# Make the script executable (Linux/Mac only)
chmod +x install.sh

# Run the installation script
./install.sh

What does the script do?

  • Builds Docker images for the client
  • Sets up Docker Compose services
  • Initializes the database automatically
  • Starts all containers and services
3

Verify Installation

Check that all Docker containers are running correctly:

terminal Terminal/CMD
# Check running containers
docker ps

# View client logs
docker-compose logs -f client
check_circle Client started! Access http://localhost:8000 to view MediNet
devices

Server Configuration

Hospital and medical center simulation

What are Servers?

Servers are hospitals or medical centers that participate in federated training. Each Server:

  • checkKeeps data locally
  • checkTrains models independently
  • checkShares only model updates
  • checkConnects to central client
1

Donwload server code

Clone the official MediNet Client repository from GitHub::

git clone https://github.com/isglobal-brge/MediNetServer
2

Navigate to Server Directory

Navigate to the Server folder within the MediNet repository:

# Navigate to server directory
cd server
3

Run Installation Script

Execute the automated server installation script:

terminal Terminal/CMD
# Make script executable (Linux/Mac only)
chmod +x install.sh

# Run Server installation
./install.sh
4

Verify Server Connection

Check that the Server Docker container is running:

# Check Server container status
docker ps

# View server logs
docker logs medinet-server
science

Testing Configuration

Verify everything works correctly

play_circle

Basic Scenario

Minimum configuration to test MediNet:

1 Server running on port 8000
2 2-3 Servers connected
3 Web access at http://localhost:8000
groups

Advanced Scenario

Complete multi-hospital simulation:

1 5+ clients simulating different hospitals
2 Diverse datasets per Server
3 Complete federated training
network_check

Verification

Check that everything works:

Web dashboard accessible
Servers appear as connected
Possible to create and train models
build

Troubleshooting

Common problems and their solutions

error

Error: Port already in use

Problem: "Error: That port is already in use"

Solution:

# Use different port
python manage.py runserver 8080

# Or find process using the port
netstat -ano | findstr :8000  # Windows
lsof -i :8000                 # macOS/Linux
warning

Error: Module not found

Problem: "ModuleNotFoundError: No module named 'django'"

Solution:

# Verify that venv is activated
which python  # macOS/Linux
where python  # Windows

# Reinstall dependencies
pip install -r requirements.txt
cloud_off

Server cannot connect

Problem: Client cannot connect to server

Solution:

# Verify that server is running
curl http://localhost:8000

# Verify correct port
python client_api.py [correct_port]

# Check firewall/antivirus
storage

Database Error

Problem: Database-related errors

Solution:

# Reset database
python manage.py flush

# Recreate migrations
python manage.py makemigrations
python manage.py migrate
cloud_upload

Production Deployment

Considerations for production environments

info

⚠️ Important

The above instructions are for local development and testing. For production deployment in real hospitals, additional security configuration, SSL certificates, and regulatory compliance are required. We are currently working on security systems to obtain ISO certifications and comply with healthcare regulations.

Production Checklist

security

Security

  • SSL/TLS certificates (in progress)
  • Robust authentication (in progress)
  • Configured firewall (in progress)
  • Audit logs (in progress)
  • ISO 27001 certification (in progress)
  • ISO 13485 compliance (in progress)
storage

Database

  • PostgreSQL in production (planned)
  • Automatic backups (planned)
  • Replication (planned)
  • Monitoring (planned)
verified_user

Compliance

  • GDPR compliance (planned)
  • HIPAA compliance (planned)
  • Regular audits (planned)
  • Legal documentation (planned)
  • FDA validation (planned)
  • CE marking process (planned)

Ready to Get Started?

Follow these steps and you'll have MediNet running in minutes