GovPay è una piattaforma completa per l'integrazione di Enti Pubblici, Intermediari e Partner tecnologici alle componenti centrali del progetto pagoPA.
Fornisce:
docker pull linkitaly/govpay:latest
docker run -d \
--name govpay \
-p 8080:8080 \
-e GOVPAY_DB_TYPE=postgresql \
-e GOVPAY_DB_SERVER=postgres:5432 \
-e GOVPAY_DB_NAME=govpay \
-e GOVPAY_DB_USER=govpay \
-e GOVPAY_DB_PASSWORD=govpay \
-v /opt/govpay/log:/var/log/govpay \
-v /etc/govpay:/etc/govpay \
linkitaly/govpay:latest
L'applicazione sarà disponibile su:
version: '3.8'
services:
postgres:
image: postgres:16-alpine
environment:
POSTGRES_DB: govpay
POSTGRES_USER: govpay
POSTGRES_PASSWORD: govpay
volumes:
- govpay-db:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U govpay"]
interval: 10s
timeout: 5s
retries: 5
govpay:
image: linkitaly/govpay:latest
depends_on:
postgres:
condition: service_healthy
ports:
- "8080:8080"
environment:
# Database
GOVPAY_DB_TYPE: postgresql
GOVPAY_DB_SERVER: postgres:5432
GOVPAY_DB_NAME: govpay
GOVPAY_DB_USER: govpay
GOVPAY_DB_PASSWORD: govpay
# Logging
GOVPAY_LOG_LEVEL: INFO
# JVM Memory
JAVA_OPTS: "-Xms512m -Xmx2g"
volumes:
- /var/log/govpay:/var/log/govpay
- /etc/govpay:/etc/govpay
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8080/govpay-api-backoffice/rs/basic/v1/info"]
interval: 30s
timeout: 10s
retries: 3
start_period: 120s
volumes:
govpay-db:
Avvio dello stack:
docker-compose up -d
latest3.9.3.p1, 3.9.3.p1_postgres, 3.9.3.p1_mariadb, 3.9.3.p1_oracle3.9.3, 3.9.3_postgres, 3.9.3_mariadb, 3.9.3_oracle3.9.2.p1, 3.9.2.p1_postgres, 3.9.2.p1_mariadb, 3.9.2.p1_oracle3.9.2, 3.9.2_postgres, 3.9.2_mariadb3.9.0, 3.9.0_postgres, 3.9.0_mariadb3.8.2, 3.8.2_postgres, 3.8.2_mariadb3.8.1, 3.8.1_postgres, 3.8.1_mariadb3.8.0, 3.8.0_postgres, 3.8.0_mariadb3.7.8, 3.7.8_postgres, 3.7.8_mariadb3.7.7, 3.7.7_postgres, 3.7.7_mariadb3.7.6, 3.7.6_postgres, 3.7.6_mariadb3.7.5, 3.7.5_postgres, 3.7.5_mariadb3.7.4, 3.7.4_postgres, 3.7.4_mariadbElenco completo: https://hub.docker.com/r/linkitaly/govpay/tags
| Variabile | Descrizione | Default |
|---|---|---|
GOVPAY_DB_TYPE | Tipo database: postgresql, mysql, mariadb, oracle, sqlserver | postgresql |
GOVPAY_DB_SERVER | Host e porta del database (host:port) | localhost:5432 |
GOVPAY_DB_NAME | Nome del database | govpay |
GOVPAY_DB_USER | Username database | govpay |
GOVPAY_DB_PASSWORD | Password database | - |
| Variabile | Descrizione | Default |
|---|---|---|
GOVPAY_LOG_LEVEL | Livello log: TRACE, DEBUG, INFO, WARN, ERROR | INFO |
GOVPAY_LOG_SQL | Abilita log SQL | false |
| Variabile | Descrizione | Default |
|---|---|---|
JAVA_OPTS | Opzioni JVM | -Xms512m -Xmx1g |
| Variabile | Descrizione | Default |
|---|---|---|
GOVPAY_PAGOPA_ENV | Ambiente pagoPA: prod, uat, dev | uat |
| Path Container | Descrizione |
|---|---|
/var/log/govpay | Directory dei log applicativi |
/etc/govpay | Directory configurazione (govpay.properties) |
/usr/local/tomcat/conf/Catalina/localhost | Context descriptor Tomcat |
/opt/govpay/upload | Directory upload tracciati CSV |
| Porta | Servizio |
|---|---|
8080 | HTTP Tomcat (tutte le API e console) |
8443 | HTTPS Tomcat (se configurato) |
Per personalizzare la configurazione oltre le variabili d'ambiente, montare un file govpay.properties:
docker run -d \
--name govpay \
-v /percorso/locale/govpay.properties:/etc/govpay/govpay.properties \
linkitaly/govpay:latest
Esempio govpay.properties:
# Configurazione Cluster
it.govpay.cluster.id=nodo1
# Configurazione Batch
it.govpay.batch.acquisizioneRendicontazioni.cron=0 */10 * * * ?
it.govpay.batch.recuperoRPTPendenti.cron=0 0 * * * ?
# Configurazione Email
it.govpay.email.host=smtp.example.com
it.govpay.email.port=587
[email protected]
it.govpay.email.password=password
# Configurazione AppIO
it.govpay.appio.enabled=true
it.govpay.appio.subscriptionKey=YOUR_SUBSCRIPTION_KEY
GovPay supporta multiple modalità di autenticazione:
Configurare l'autenticazione tramite:
govpay.properties (per configurazioni avanzate)docker run -d \
--name govpay \
-p 8443:8443 \
-v /percorso/certificati:/opt/govpay/ssl \
-e GOVPAY_SSL_ENABLED=true \
-e GOVPAY_SSL_KEYSTORE=/opt/govpay/ssl/keystore.jks \
-e GOVPAY_SSL_KEYSTORE_PASSWORD=changeit \
linkitaly/govpay:latest
Al primo avvio, GovPay richiede un database vuoto. Gli script SQL per l'inizializzazione sono inclusi nell'immagine:
# Per PostgreSQL
docker exec -i govpay cat /opt/govpay/sql/postgresql/gov_pay.sql | \
psql -h localhost -U govpay -d govpay
# Per MySQL
docker exec -i govpay cat /opt/govpay/sql/mysql/gov_pay.sql | \
mysql -h localhost -u govpay -p govpay
L'immagine include endpoint per verificare lo stato dell'applicazione:
# Health check applicazione
curl http://localhost:8080/govpay-api-backoffice/rs/basic/v1/info
# Health check database
curl http://localhost:8080/govpay-api-backoffice/rs/basic/v1/info
Risposta di esempio:
{
"versione": "3.8.2",
"ambiente": "PROD",
"build": "2025-12-10"
}
# PostgreSQL
docker exec postgres pg_dump -U govpay govpay > backup_govpay_$(date +%Y%m%d).sql
# MySQL
docker exec govpay-mysql mysqldump -u govpay -p govpay > backup_govpay_$(date +%Y%m%d).sql
docker cp govpay:/etc/govpay ./backup_config_$(date +%Y%m%d)
# 1. Backup database
docker exec postgres pg_dump -U govpay govpay > backup_pre_upgrade.sql
# 2. Stop container
docker-compose down
# 3. Pull nuova versione
docker pull linkitaly/govpay:3.8.2
# 4. Aggiorna docker-compose.yml con nuova versione
# 5. Riavvio (applica patch SQL automaticamente)
docker-compose up -d
# 6. Verifica log
docker-compose logs -f govpay
# Verifica log
docker logs govpay
# Verifica connessione database
docker exec govpay cat /etc/govpay/govpay.properties | grep datasource
# Aumenta memoria JVM
docker run -e JAVA_OPTS="-Xms1g -Xmx4g" linkitaly/govpay:latest
# Verifica utilizzo risorse
docker stats govpay
# ATTENZIONE: Cancella tutti i dati
docker-compose down -v
docker volume rm govpay-db
docker-compose up -d
version: '3.8'
services:
nginx:
image: nginx:alpine
ports:
- "80:80"
- "443:443"
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf
depends_on:
- govpay-1
- govpay-2
govpay-1:
image: linkitaly/govpay:latest
environment:
GOVPAY_CLUSTER_ID: node1
# ... altre configurazioni
govpay-2:
image: linkitaly/govpay:latest
environment:
GOVPAY_CLUSTER_ID: node2
# ... altre configurazioni
postgres:
image: postgres:16-alpine
# ... configurazione database
Per supporto e domande:
Questo progetto è rilasciato sotto licenza GPL-3.0. Vedere il file LICENSE per i dettagli.
Copyright (c) 2014-2026 Link.it srl
Content type
Image
Digest
sha256:8bbbef13f…
Size
1 GB
Last updated
2 days ago
docker pull linkitaly/govpay