Skip to main content

System Prerequisites

This page lists the prerequisites necessary to install and run PCH-SIG.

Server Configuration​

Production Server​

ResourceMinimumRecommended
CPU4 cores8 cores
RAM8 GB16 GB
Storage100 GB SSD500 GB SSD
Network100 Mbps1 Gbps

Development Server​

ResourceMinimum
CPU2 cores
RAM4 GB
Storage50 GB

Operating System​

Supported​

OSVersionNotes
Windows Server2019, 2022Via Docker Desktop or Docker Toolbox
Windows10, 11 ProVia Docker Desktop
Ubuntu20.04, 22.04 LTSRecommended for production
Debian11, 12Supported
CentOS/RHEL8, 9Supported

Windows Configuration​

For Windows without Hyper-V (like server serveur-production):

  • Docker Toolbox with VirtualBox
  • Docker VM on 192.168.99.100
  • Port proxy via netsh interface portproxy

Required Software​

Docker​

ComponentMinimum version
Docker Engine20.10+
Docker Compose2.0+

For development​

SoftwareVersionUsage
Node.js18.x LTSFrontend build
npm9.x+Package manager
PHP8.3Symfony backend
Composer2.xPHP dependencies
Git2.xVersion control

Network Ports​

Ports to open​

PortServiceDirection
80HTTP (Frontend)Inbound
443HTTPSInbound
3000Frontend devInbound
8000Backend APIInbound
5432PostgreSQLInternal
6379RedisInternal

Windows firewall configuration​

# Open port 3000
netsh advfirewall firewall add rule name="PCH-SIG Frontend" dir=in action=allow protocol=tcp localport=3000

# Open port 8000
netsh advfirewall firewall add rule name="PCH-SIG API" dir=in action=allow protocol=tcp localport=8000

Database​

PostgreSQL​

ParameterValue
Version15.x
PostGIS Extension3.4
EncodingUTF-8
Collationfr_FR.UTF-8
DataSpace
Initial database100 MB
10,000 households500 MB
100,000 households5 GB
Logs 1 year10 GB

Supported Browsers​

End users​

BrowserMinimum version
Chrome90+
Firefox90+
Edge90+
Safari14+

Required features​

  • JavaScript enabled
  • Cookies enabled
  • LocalStorage available
  • WebSocket (for real-time notifications)

Connectivity​

Internet Access​

UsageRequired
Initial installationYes (Docker image download)
Normal operationNo (local application)
UpdatesYes
KoBo integrationYes

Internal Network Access​

ServiceAccess
PostgreSQL serverFrom backend
Redis serverFrom backend
Backend APIFrom frontend

Prerequisites Verification​

Verification script (Linux)​

#!/bin/bash
echo "=== PCH-SIG prerequisites verification ==="

# Docker
echo -n "Docker: "
docker --version 2>/dev/null || echo "NOT INSTALLED"

# Docker Compose
echo -n "Docker Compose: "
docker compose version 2>/dev/null || echo "NOT INSTALLED"

# Ports
echo -n "Port 3000: "
netstat -tlnp | grep :3000 && echo "IN USE" || echo "FREE"

echo -n "Port 8000: "
netstat -tlnp | grep :8000 && echo "IN USE" || echo "FREE"

# Disk space
echo "Disk space:"
df -h /

Windows verification (PowerShell)​

# Docker
docker --version

# Ports
netstat -an | Select-String ":3000"
netstat -an | Select-String ":8000"

# Disk space
Get-PSDrive C | Select-Object Used, Free

Next steps​

Once prerequisites are verified: