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

---
 Quick-Start.md | 134 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 134 insertions(+)
 create mode 100644 Quick-Start.md

diff --git a/Quick-Start.md b/Quick-Start.md
new file mode 100644
index 0000000..fdacf6a
--- /dev/null
+++ b/Quick-Start.md
@@ -0,0 +1,134 @@
+# Quick Start
+
+## 1. Prepare environment
+
+Copy the sample environment file:
+
+```bash
+cp .env.sample .env
+```
+
+Edit `.env` and set at least:
+
+```env
+ROMEXIS_VERSION=6.5.3.444.203
+TARGETARCH=amd64
+
+REGISTRY=gitea.buchhorster.de/patrick
+ROMEXIS_IMAGE=romexis-server
+
+HOST_IP=<your-server-ip>
+
+MSSQL_SA_PASSWORD=<strong-password>
+ROMEXIS_DB_PASSWORD=<strong-password>
+```
+
+---
+
+## 2. Start default MSSQL stack
+
+```bash
+docker compose up -d
+```
+
+Show logs:
+
+```bash
+docker compose logs -f romexis
+docker compose logs -f mssql
+```
+
+---
+
+## 3. Start Firebird stack
+
+If using the Firebird compose variant:
+
+```bash
+docker compose -f docker-compose.firebird.yml up -d
+```
+
+Or combine the base compose file with a Firebird override:
+
+```bash
+docker compose   -f docker-compose.yml   -f docker-compose.firebird.yml   up -d
+```
+
+---
+
+## 4. Recreate after image changes
+
+```bash
+docker compose up --force-recreate -d
+```
+
+With rebuild:
+
+```bash
+docker compose up --build --force-recreate -d
+```
+
+No cache rebuild:
+
+```bash
+docker compose build --no-cache --pull
+docker compose up --force-recreate -d
+```
+
+---
+
+## 5. Open a shell in the Romexis container
+
+```bash
+docker exec -it romexis-server bash
+```
+
+If bash is unavailable:
+
+```bash
+docker exec -it romexis-server sh
+```
+
+With Compose:
+
+```bash
+docker compose exec romexis bash
+```
+
+---
+
+## 6. Check database initialization
+
+Inside the Romexis container:
+
+```bash
+/opt/init-romexis-db.sh
+```
+
+Verbose database initialization:
+
+```bash
+DB_CREATE_VERBOSE=1 /opt/init-romexis-db.sh
+```
+
+For Firebird debugging:
+
+```bash
+ISQL=isql-fb DB_CREATE_VERBOSE=1 bash -x /opt/init-romexis-firebird-db.sh
+```
+
+---
+
+## 7. Stop the stack
+
+```bash
+docker compose down
+```
+
+Stop and remove volumes:
+
+```bash
+docker compose down -v
+```
+
+Use volume removal carefully because it deletes persistent database/application data.