From e803f01e6d4ce25fd51a4eb27860b48551926f6f Mon Sep 17 00:00:00 2001
From: Patrick Gniza <pgniza@gmx.de>
Date: Sun, 28 Jun 2026 19:47:49 +0000
Subject: [PATCH] =?UTF-8?q?Microsoft=20SQL=20Server=20hinzugef=C3=BCgt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Microsoft-SQL-Server.md | 77 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 Microsoft-SQL-Server.md

diff --git a/Microsoft-SQL-Server.md b/Microsoft-SQL-Server.md
new file mode 100644
index 0000000..4538e1f
--- /dev/null
+++ b/Microsoft-SQL-Server.md
@@ -0,0 +1,77 @@
+# Microsoft SQL Server
+
+Microsoft SQL Server is the default and most tested database backend.
+
+---
+
+## Compose Service
+
+The MSSQL service uses the official Microsoft SQL Server image:
+
+```yaml
+mssql:
+  image: mcr.microsoft.com/mssql/server:2022-latest
+  container_name: romexis-mssql
+  environment:
+    ACCEPT_EULA: "Y"
+    MSSQL_SA_PASSWORD: "${MSSQL_SA_PASSWORD}"
+    MSSQL_PID: "${MSSQL_PID:-Express}"
+  ports:
+    - "${MSSQL_PORT}:1433"
+  volumes:
+    - mssql_data:/var/opt/mssql
+    - ${DATABASE_BACKUP_DIR}:/var/opt/mssql/backup
+```
+
+---
+
+## Romexis Settings
+
+```env
+SERVER_DB=5
+MSSQL_HOST=mssql
+MSSQL_PORT=1433
+MSSQL_SA_PASSWORD=<strong-password>
+
+ROMEXIS_DB_NAME=Romexis_db
+ROMEXIS_DB_USER=romexis
+ROMEXIS_DB_PASSWORD=<strong-password>
+```
+
+Generated JDBC URL:
+
+```text
+jdbc:sqlserver://mssql:1433;databaseName=Romexis_db;encrypt=true;trustServerCertificate=true;
+```
+
+---
+
+## Initialization
+
+The MSSQL initializer:
+
+```text
+/opt/init-romexis-mssql-db.sh
+```
+
+Responsibilities:
+
+- wait for SQL Server
+- create Romexis database if missing
+- create/update Romexis database user
+- import base SQL scripts
+- import update scripts up to the target schema marker
+- update runtime paths in `RBA_Server_Param_S`
+
+---
+
+## Backup Directory
+
+`DATABASE_BACKUP_DIR` is mounted into both the migration service and SQL Server:
+
+```text
+Migration service: /upload/database
+SQL Server:        /var/opt/mssql/backup
+```
+
+This allows the migration service to upload a `.bak` file and trigger a database restore.