
Self-hosted Information Security Management System — ISO 27001, NIS2, GDPR/DSGVO, BSI IT-Grundschutz
<!-- © 2026 Claude Hecker — ISMS Builder V 1.76 — AGPL-3.0 -->

# ISMS Builder
**Self-hosted Information Security Management System — open source, no cloud required**
[](https://github.com/coolstartnow/isms-builder/actions/workflows/ci.yml)
[](https://github.com/coolstartnow/isms-builder/actions)
[](LICENSE)
[](https://nodejs.org)
[](CHANGELOG.md)
📖 **[Wiki](https://github.com/coolstartnow/isms-builder/wiki)** — Docker-Image-Nutzung &
Umgebungsvariablen, Architektur & Module, FAQ, Mitwirken (DE/EN)
<!-- GDPR NOTE: The four badges above (CI, Tests, License, Node.js) load resources
from external servers (github.com, shields.io/Cloudflare, img.shields.io).
When this README is rendered in a browser, these requests transmit the viewer's
IP address to third parties (incl. US-based servers — GDPR Art. 44 ff.).
For 100% GDPR-compliant self-hosted documentation, replace these four badge
lines with their local equivalents from docs/badges/ or remove them entirely. -->
---
> ## ⚠️ Security Warning: Fake repositories and copies distributing malware
> ISMS Builder has **no packaged "releases", installers, or downloadable ZIP files** — the only
> legitimate source is this repository, cloned or downloaded directly from GitHub as plain
> source code. We are aware of at least one **malicious repository impersonating this project**
> (fake README, fake "Download" button linking to a ZIP disguised as a screenshot, containing a
> Windows malware loader — `.cmd` → `.exe` → Lua-DLL payload chain). **Do not download or run any
> "isms_builder" ZIP/installer/exe from anywhere other than this repository.**
> If you find a suspicious repo or site impersonating this project, please open an
> [issue](https://github.com/coolstartnow/isms-builder/issues) or a
> [discussion](https://github.com/coolstartnow/isms-builder/discussions) so we can flag it.
---
> **Status: Active development — not yet a finished product.**
> The core modules are functional and in use, but some features are incomplete
> and the platform is still growing. Contributions, feedback and real-world
> testing are very welcome — that is exactly why this was open-sourced.
---
> 🛡️ **Related project: [NIS2 Quick-Check](https://github.com/coolstartnow/nis2-quickcheck)** —
> a free, standalone NIS2 self-check (10 domains × 5 questions, all 27 EU member states, all 24
> EU official languages). Runs entirely in the browser, no backend, no install. Not part of
> ISMS Builder and not required to use it — just a companion tool for a quick first orientation.
---
## What is ISMS Builder?
ISMS Builder is a **self-hosted web platform** for managing an Information Security Management System (ISMS).
It covers the full compliance lifecycle — from policy authoring to audit evidence — for ISO 27001:2022, NIS2, GDPR/DSGVO, BSI IT-Grundschutz and other frameworks.
**No cloud. No SaaS fees. Your data stays on your server.**
> Designed for SMEs, IT teams, and consultants who need a real ISMS tool without a five-figure vendor contract.
---
## Intended Use and Scope
This project began as a working tool for a single ISMS practitioner and grew from there. It is
open source because the work may be useful to others — not because it is a commercial product in
disguise. Being explicit about that helps you decide whether it fits your situation.
**What it is built for.** A small ISMS team — often one person, sometimes a handful — that
authors and maintains the documentation of a management system: policies, risks, assets,
controls, evidence. The number of people who *need an account* is expected to stay small.
Reaching a large audience works without accounts: policy acknowledgements are sent as
token-based links, so recipients read and confirm a document without ever logging in, and
without appearing in any user list.
**What it expects of you.** ISMS Builder is self-hosted, and everything that follows from that
is yours: deployment, TLS, hardening, backups, updates, access control, and the data protection
obligations for whatever you store in it. The project ships a reasonable default configuration,
not a managed service.
**What it is not.** There is no hosted SaaS offering, no commercial support contract, and no
service-level agreement. It is not a multi-tenant hosting product. It does not certify you
against any standard, and it is not legal advice — it helps you organise and evidence the work,
but the assessment remains yours and your auditor's.
**Who maintains it.** One person, alongside a full-time job. Issues and discussions are read and
answered, usually within days; security reports are prioritised. Feature requests are welcome and
genuinely shape the roadmap, but they compete for limited evenings. If your organisation depends
on a fixed timeline or guaranteed response, a commercial vendor is the honest recommendation —
and that is not a reason to avoid the project, only a reason to plan realistically.
---
## Screenshots
| Login | Dashboard |
|---|---|
|  |  |
| Statement of Applicability | Risk Management |
|---|---|
|  |  |
| GDPR & Datenschutz | Asset Management |
|---|---|
|  |  |
| Guidance & Dokumentation | Reports |
|---|---|
|  |  |
| Measures register | Measures for a control |
|---|---|
|  |  |
> Run `npm start` and open `https://localhost:3000` to explore the full demo dataset locally.
---
## Feature Overview
| Module | Description | Standards |
|---|---|---|
| **Policy Management** | Template CRUD, versioning, lifecycle (draft → review → approved → archived), space hierarchy, attachments | ISO 27001 §5 |
| **Statement of Applicability** | 147 built-in controls across 5 frameworks (BSI IT-Grundschutz, EU NIS2, EUCS, EU AI Act, CRA) plus ISO 27001 / 9000 / 9001 controls you import yourself (never shipped), the **Custom Controls** tab and every other framework tab can be switched off under Administration → Modules when you do not use them (existing controls are kept), **own groups** (your own frameworks such as NEN 7510, TISAX or a customer requirement, with their own tab: create them and import the controls from a JSON file with preview and merge — no standard texts shipped; [docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/template-type-soa.md)), inline editing, gap analysis, cross-mapping | ISO 27001 A / BSI / NIS2 / EUCS / EUAI / ISO 9001 / CRA |
| **Measures Register** | One register for risk treatments, actions for audit findings, governance measures and TOMs — responsible person, due date, status, evidence; assignable to SoA controls, findings and risks; shown in SoA, risks, findings, governance and GDPR, upgraded automatically from earlier versions ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-measures.en.md)) | ISO 27001 §6.1.3 / GDPR Art. 32 |
| **Risk Management** | Risk register, treatment plans (kept in the measures register), auditor role | ISO 27001 §6.1 |
| **Security Goals** | KPI tracking with progress bars, calendar integration | ISO 27001 §6.2 |
| **GDPR & Privacy** | VVT, AV-contracts, DSFA, TOMs, DSAR queue, 72h-timer, deletion log with email alerts | DSGVO Art. 13–35 |
| **Asset Management** | Asset register sorted by category, type and name with sortable columns, editable asset types, protection goals (CIA + authenticity) with dependency inheritance, classification levels, EoL tracking | ISO 27001 A.5.9–5.12 |
| **BCM / BCP** | Business Impact Analysis, continuity plans, exercises, templates for all three, register of ISO 22301 requirements (import from your licensed edition) | ISO 27001 A.5.29–5.30 / NIS2 |
| **Training Records** | Training catalogue, completion tracking, evidence files, confirmation of participation (PDF) | ISO 27001 A.6.3 |
| **Supplier Management** | Vendor register, audit scheduling, risk assessment | ISO 27001 A.5.19–5.22 |
| **Legal & Contracts** | Contracts, NDAs, privacy policies, expiry calendar | |
| **Incident Inbox** | CISO inbox + **public reporting form** (no login required) | NIS2 / BSI |
| **Governance** | Management reviews, meeting minutes, governance measures (kept in the measures register) | ISO 27001 §9.3 |
| **Reports** | Compliance matrix (Control × Entity), gap report, review cycles, CSV export | |
| **Audit Findings** | Finding register (IST→SOLL→Risk→Recommendation), action plans, severity/status tracking, FIND-YYYY-NNNN ref | ISO 27001 §9.2 |
| **Audit Management** | Audits with checklists, findings created from non-conformities, annual audit programme (quarterly plan, approval), calendar and dashboard integration, CSV/PDF export | ISO 27001 §9.2, ISO 19011 |
| **Policy Acknowledgements** | Verifiable distribution of policies to staff and confirmation of understanding, central audit evidence ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-policy-acknowledgements.en.md)) | ISO 27001 7.3, A.6.3 |
| **NIS2** | Art. 21 governance checklist (30 items) and Art. 23 reporting deadlines with automatic alerts | NIS2 Art. 21 / 23 |
| **Calendar** | One calendar for due dates across the modules: measures, risk treatments, audits, reviews, contracts, trainings, deadlines | |
| **Guidance** | Built-in handbook and knowledge base (module guides, role guides, own documents) with search, in six languages | |
| **Organisation & Company Logo** | Organisation settings (responsibilities, languages, notifications, SMTP, WebDAV, menu order, organisational units) and an uploadable company logo shown on the login page, policy PDFs and print views; the ISMS Builder logo ships with the demo set ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-organisation.en.md)) | |
| **Data Protection Impact Assessment (DPIA)** | Nine ready-made templates (HR in the cloud, video surveillance, employee monitoring, AI services, profiling, health data, biometrics, whistleblowing, recruiting), a pre-check "is a DPIA needed?", a DPO review before approval and a print view; the company prepares it, the DPO reviews it ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-dsfa.en.md)) | GDPR Art. 35 |
| **GDPR templates** | Ready-made templates for records of processing activities (14), processing agreements (12), data breaches (10), data subject replies (10) and technical and organisational measures (24), in six languages; pre-fill the form, to be adapted carefully to your own company, not legal advice ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-gdpr.en.md)) | GDPR Art. 30, 28, 33, 12–22, 32 |
| **AI Drafts (Policy Assistant)** | Draft a document from a fixed title list with the connected AI (Ollama) or by copy and paste with an AI of your choice; a filter blocks personal and technical data, placeholders are filled locally from the organisation data ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-ai-drafts.en.md)) | |
| **Mobile App (Android)** | Separate Android app that works offline with its own data set and syncs with the server over Wi-Fi or a file bundle: sync accounts with per-module rights, set-up by QR code, templates, SoA, risks, assets, findings and guidance (read-only); requires `STORAGE_BACKEND=json` ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-mobile-sync.en.md)). Not publicly released yet: if you would like to try it beforehand, get in touch via the [project website](https://www.isms-builder.com/#contact) | |
| **Traceability** | Every record links to SoA controls + policy documents — bidirectional | |
| **Semantic Search** | Local AI search via Ollama (nomic-embed-text) with keyword fallback; the AI address, models and an **optional API key** (sent as `Authorization: Bearer`, e.g. to a gateway in front of Ollama, so its log identifies the ISMS Builder's requests) are set under Administration; the key is never shown again, logged or exported | |
| **Multi-Entity** | Corporate structure tree, per-entity applicability for controls and policies | |
| **Multilingual UI & Demo Data** | Full UI, demo content and module documentation in 🇩🇪 DE / 🇬🇧 EN / 🇫🇷 FR / 🇳🇱 NL / 🇭🇺 HU / 🇪🇪 ET; admin controls available languages. The FR, NL, HU and ET texts are own translations — a review by native speakers is recommended | |
---
### ⚠ IMPORTANT: ISO Controls Require Manual Installation by the Administrator
> **ISO 27001:2022, ISO 9000:2015, and ISO 9001:2015** are copyright-protected standards published
> by the International Organization for Standardization (ISO, © ISO). The control definitions
> (titles, descriptions, requirement text) are **not included** in this software and must **not**
> be redistributed without a valid ISO licence.
**What this means in practice:**
The SoA modules for ISO 27001, ISO 9000, and ISO 9001 ship without control content.
The administrator **must manually import** the controls before these frameworks are usable:
1. Obtain a licensed copy of the standard from [iso.org](https://www.iso.org/) or an authorised national body
2. Prepare a JSON file with your control definitions (format documented in `scripts/import-iso-controls.sh`)
3. Run the import script:
```bash
bash scripts/import-iso-controls.sh path/to/iso-controls.json
```
4. Restart the ISMS Builder server
> **Frameworks included out-of-the-box (no ISO licence required):**
> BSI IT-Grundschutz, EU NIS2, EUCS, EU AI Act, and CRA are based on publicly available
> EU legislation and German federal publications and are fully pre-installed.
>
> **Other frameworks (NEN 7510, TISAX, customer requirements, …):** an administrator creates an *own group* in the SoA
> (button **+ Own group**) and imports the controls from a JSON file — with a preview, merged instead of replaced, and without
> any standard text being shipped. Only import content you are licensed to use
> (example file: `docs/examples/soa-custom-framework.example.json`). The ISO import above stays limited to ISO 27001, 9000 and 9001.
>
> **Legal notice:** The standard texts of ISO 27001/9000/9001, NEN 7510 and the TISAX assessment catalogues (VDA ISA) are subject to the rights of their publishers (copyright and trademark law) and are not shipped with ISMS Builder. Example controls in demo data are our own invented placeholder texts with no connection to the wording of the standards — incomplete and usable neither for certifications nor for TISAX assessments. Only import texts you are licensed to use. This is not legal advice.
Operating the ISO framework modules without a valid licence for the respective standard is the
sole responsibility of the operator. The ISMS Builder project and its contributors accept no
liability for unlicensed use of ISO-protected content.
---
## Quick Start
```bash
git clone https://github.com/coolstartnow/isms-builder.git
cd isms-builder
npm install
cp .env.example .env # set JWT_SECRET to a long random string
npm start # http://localhost:3000
```
Login with **`[email protected]` / `adminpass`**. On first login you will be prompted to choose your **demo data language** (🇩🇪 DE / 🇬🇧 EN / 🇫🇷 FR / 🇳🇱 NL / 🇭🇺 HU / 🇪🇪 ET) or start with an empty system. Change the admin password immediately after. See [Demo accounts](#demo-accounts) for the other test accounts.
For production use with HTTPS:
```bash
# .env
JWT_SECRET=<output of: openssl rand -hex 32> # required; production refuses a missing, short or placeholder secret
STORAGE_BACKEND=json
SSL_CERT_FILE=/etc/ssl/certs/your.crt
SSL_KEY_FILE=/etc/ssl/private/your.key
```
**Going live?** Production is always a **fresh installation** – demo and production are never mixed.
Do not turn a demo instance (or its data) into a production system: install a new instance
(`STORAGE_BACKEND=json` is the recommended default, see `.env.example`), create your own administrator
and set your own secrets. The in-app *Demo Reset* and *Demo Import* are functions of the demo
instance only: they are not a backup, restore or migration tool, and *Demo Import* works with
`STORAGE_BACKEND=json` only.
The built-in SoA frameworks (BSI IT-Grundschutz, EU NIS2, EUCS, EU AI Act, CRA) are created
automatically on every storage backend. The control texts of ISO 27001 / 9000 / 9001 are
copyrighted by ISO and are **never** shipped – provide them yourself in `data/iso-controls.json`
(see `scripts/import-iso-controls.sh`).
---
### Demo accounts
The demo set contains these accounts, so every role and function can be tried. **The passwords are public and for demo use only.**
| User | Login (e-mail) | Password | Role | Function | Use it to test |
|---|---|---|---|---|---|
| admin | `[email protected]` | `adminpass` | Administrator | CISO + DPO | everything, including administration |
| ciso | `[email protected]` | `cisopass` | Content Owner | **CISO** | the CISO function without administrator rights (like carla) |
| dsb | `[email protected]` | `dsbpass` | Content Owner | **DPO** | the DPO function without administrator rights (like dana) |
| alice | `[email protected]` | `alicepass` | Department head | none | policies, risks and guidance (read and write) |
| bob | `[email protected]` | `bobpass` | Reader | none | read-only access |
| carla | `[email protected]` | `carlapass` | Content Owner | **CISO** | preparing and approving a DPIA; she may **not** enter the DPO opinion |
| dana | `[email protected]` | `danapass` | Content Owner | **DPO** | entering the DPO opinion on a DPIA |
carla and dana are two separate people without administrator rights, so the DPIA review can be tested as intended: carla prepares the DPIA, dana enters the opinion, carla approves. ciso and dsb are the same two functions as separate accounts.
**Which accounts exist depends on how you start:**
- **Docker image / fresh installation without a data directory:** admin, alice, bob, carla, dana.
- **Source checkout (`git clone`):** the repository ships `data/rbac_users.json` with admin, ciso, dsb, alice, bob. carla and dana are added by the demo import or by loading a demo bundle (2FA switched off).
- **Public demo (`DEMO_HOSTING`):** the passwords of all seven accounts listed above are kept at these public values; accounts that do not exist in that data set are skipped.
- Switching to production (Admin → Maintenance → Demo reset) deletes all of them except `admin`. Change the admin password immediately after.
## Docker
Every release is published as a GitHub Package in the GitHub Container Registry, for
`linux/amd64` and `linux/arm64` — tagged `:latest` and `:<version>` (e.g. `:1.37.5.2`):
```bash
docker compose up -d
# App runs at http://localhost:3000
```
Or without Compose (`data/` must be a bind mount — data is never baked into the image):
```bash
docker run -d --name isms-builder -p 3000:3000 \
-e JWT_SECRET="$(openssl rand -hex 32)" \
-v "$PWD/data:/app/data" \
ghcr.io/coolstartnow/isms-builder:latest
```
This is the default, storing data as plain JSON files in `./data` — no database container needed
at all. It's the recommended setup for small teams and is what the two commands above use.
**Using PostgreSQL (or MariaDB) instead of JSON.** The image supports this out of the box, but —
unlike the JSON setup above — it needs a second container (the actual database) plus a handful of
environment variables telling the app how to reach it. If you only pulled the image itself
(`docker pull ghcr.io/coolstartnow/isms-builder`) without ever cloning this repository, those
variable names aren't visible anywhere by default — `docker-compose.yml` and `.env.example`, where
they're documented, are files in this Git repository, not part of the image. This section exists
so that information isn't a repo-only secret.
The `isms-builder` image itself never bundles a database server — `postgres:17` (or `mariadb:11`)
is a completely generic, empty database engine from Docker Hub with zero knowledge of this
project's tables. Those tables (risks, assets, SoA controls, and so on) are created automatically
by the application itself the moment it starts up and finds an empty database — no manual SQL
import, no separate migration step you have to run. See "How does the database schema get
created?" below if you want the full mechanics.
Two containers, one shared Docker network, then the app is told where to find the database:
```bash
# 1) An isolated network so the two containers can reach each other by name
docker network create isms-net
# 2) The database — empty until the app first connects and creates its tables
docker run -d --name isms-postgres --network isms-net \
-e POSTGRES_DB=isms_builder \
-e POSTGRES_USER=isms \
-e POSTGRES_PASSWORD="$(openssl rand -hex 16)" \
-v isms-postgres-data:/var/lib/postgresql/data \
postgres:17-alpine
# 3) The app, pointed at that database by container name (isms-postgres) via
# Docker's built-in DNS on the shared network — no host/port juggling needed
docker run -d --name isms-builder --network isms-net -p 3000:3000 \
-e JWT_SECRET="$(openssl rand -hex 32)" \
-e STORAGE_BACKEND=postgres \
-e DB_HOST=isms-postgres \
-e DB_PORT=5432 \
-e DB_USER=isms \
-e DB_PASS="<same password as POSTGRES_PASSWORD above>" \
-e DB_NAME=isms_builder \
ghcr.io/coolstartnow/isms-builder:latest
```
What each variable means:
| Variable | Purpose |
|---|---|
| `STORAGE_BACKEND` | `postgres` (or `pg`) for PostgreSQL, `mariadb` for MariaDB/MySQL. Leave unset (or `json`) for the default JSON setup. |
| `DB_HOST` | Hostname of the database container. On a shared Docker network, this is just the container's `--name` — Docker resolves it automatically. |
| `DB_PORT` | `5432` for PostgreSQL, `3306` for MariaDB. |
| `DB_USER` / `DB_PASS` / `DB_NAME` | Must match whatever you set on the database container (`POSTGRES_USER`/`POSTGRES_PASSWORD`/`POSTGRES_DB` above, or the MariaDB equivalents). |
For MariaDB, swap `postgres:17-alpine` for `mariadb:11`, use its `MARIADB_DATABASE` /
`MARIADB_USER` / `MARIADB_PASSWORD` variables in step 2, and `STORAGE_BACKEND=mariadb` /
`DB_PORT=3306` in step 3. The full, cross-referenced list of every environment variable this
project understands — including the ones not covered here (SSL, reverse-proxy trust, SMTP,
2FA, …) — lives in [`.env.example`](https://github.com/coolstartnow/isms-builder/blob/main/.env.example) in this repository.
Compose users get this for free: `docker-compose.yml` already ships `mariadb` and `postgres`
service profiles (commented out by default, alongside the equivalent env-var explanations) —
`docker compose --profile postgres up -d` starts both containers wired together automatically,
no manual networking or copy-pasting of passwords required.
**How does the database schema get created?** Neither the `postgres:17` nor the `mariadb:11`
image knows anything about this project — they're generic, empty database engines straight from
Docker Hub. There's no SQL dump file to import and no separate migration command to run by hand.
Instead, the moment the `isms-builder` container starts up and connects to an empty database, its
own application code (not the database image) creates every table it needs on the spot — see
[`server/db/knexDatabase.js`](https://github.com/coolstartnow/isms-builder/blob/main/server/db/knexDatabase.js): a list of table definitions, each
checked with `hasTable()` and created with `createTable()` if missing, all before the app starts
accepting HTTP requests. That makes it idempotent — the very first start builds the full schema
from nothing, and every later restart against the same database is a silent no-op because the
tables already exist. This is the same mechanism, unmodified, that was live-verified against
SQLite, MariaDB 11, and PostgreSQL 17 (see [#70](https://github.com/coolstartnow/isms-builder/issues/70)).
To build from source instead, uncomment the `build:` block in `docker-compose.yml` and run
`docker compose up -d --build`.
Images carry a signed build provenance attestation:
```bash
gh attestation verify oci://ghcr.io/coolstartnow/isms-builder:latest --owner coolstartnow
```
---
## Requirements
- **Node.js 18+** (tested: 18, 20, 22)
- npm 9+
- (Optional) Docker + Docker Compose
- (Optional) [Ollama](https://ollama.ai) for local AI semantic search
---
## Configuration (`.env`)
| Variable | Default | Description |
|---|---|---|
| `JWT_SECRET` | *(required)* | Secret for JWT signing — at least 32 random characters (`openssl rand -hex 32`). With `NODE_ENV=production` (always the case in the Docker image) the server does not start with a missing, short or placeholder secret |
| `PORT` | `3000` | HTTP/HTTPS listen port |
| `STORAGE_BACKEND` | `json` | `json` (default and current recommendation; required by the mobile app), `sqlite`, `mariadb` or `postgres` |
| `SSL_CERT_FILE` | — | Path to TLS certificate → enables HTTPS |
| `SSL_KEY_FILE` | — | Path to TLS private key |
| `DATA_DIR` | `./data` | Override data directory (Docker volumes) |
| `SMTP_HOST` | — | SMTP server for email alerts |
| `SMTP_PORT` | `587` | SMTP port |
| `SMTP_USER` | — | SMTP username |
| `SMTP_PASS` | — | SMTP password |
| `SMTP_FROM` | — | Sender address for notifications |
---
## Architecture
```
server/
index.js — Express app setup, router mounts
auth.js — JWT auth, RBAC ranks, session
routes/ — 17 Express route modules (one per domain)
db/ — Data stores (jsonStore / sqliteStore / orgSettingsStore / …)
ai/ — Semantic search (embedder, embeddingStore, lexicalSearch)
reports.js — Report generation logic
ui/
index.html — SPA shell (Atlassian Dark Theme)
app.js — All render functions, ~6000 lines vanilla JS
style.css — CSS variables, dark theme
data/ — JSON files / SQLite DB (gitignored)
docs/
ISMS-build-documentation.md — Full architecture reference
architecture/ — C4 diagrams, data model, OpenAPI 3.0.3 spec
tests/ — Jest + Supertest (176 tests, --runInBand)
```
- **Auth:** JWT cookie (`sm_session`), bcrypt passwords, TOTP 2FA (enforceable org-wide)
- **RBAC:** `reader` → `editor` / `dept_head` → `contentowner` / `auditor` → `admin`
- **Persistence:** JSON files (default, recommended) or SQL databases: SQLite via `better-sqlite3`, MariaDB/MySQL, PostgreSQL
- **AI:** Optional local Ollama (nomic-embed-text); keyword search always available as fallback
- **Audit Log:** Every create/update/delete/login action recorded, filterable, exportable
See [`docs/architecture/`](https://github.com/coolstartnow/isms-builder/blob/main/docs/architecture) for C4 diagrams, full data model, and OpenAPI 3.0.3 spec (80+ endpoints).
---
## Running Tests
> **Note:** The test suite under `tests/` is the author's personal development tests and is
> shipped alongside the project for transparency. It is **not** part of the application itself
> and is **not required** to run the app. The tests cover internal API behaviour and use
> hardcoded test credentials that only exist in the isolated test environment — they have no
> relation to any production or demo data.
```bash
npm test # runs all 423 tests
npm run preflight # exactly what CI gates on (tests + pinning + audit)
npm test -- --verbose # with test names
```
Tests use an isolated temp directory — no production data is touched.
---
## Contributing
Contributions are very welcome! See [CONTRIBUTING.md](https://github.com/coolstartnow/isms-builder/blob/main/CONTRIBUTING.md) for:
- Development setup (5 minutes to first test run)
- Code style and conventions
- How to open a good issue or PR
**Found a security issue?** Please do not open a public issue — use
[private vulnerability reporting](https://github.com/coolstartnow/isms-builder/security/advisories/new).
[SECURITY.md](https://github.com/coolstartnow/isms-builder/blob/main/SECURITY.md) describes the scope, the safe harbour, and what to realistically expect.
**Good first issues** are labelled [`good first issue`](https://github.com/coolstartnow/isms-builder/issues?q=label%3A%22good+first+issue%22) in the issue tracker.
---
## Roadmap
| Status | Feature |
|---|---|
| ✅ Done | Semantic search (Ollama / nomic-embed-text) |
| ✅ Done | SQLite backend, Docker, CI/CD |
| ✅ Done | GDPR deletion log email alerts |
| ✅ Done | Multilingual demo bundles (DE / EN / FR / NL / HU / ET) |
| ✅ Done | Audit Findings module with action plans (V 1.37.2.0) |
| ✅ Done | FR/NL Guidance translations + admin language configuration (V 1.37.2.0) |
| ✅ Done | MariaDB/MySQL backend (`STORAGE_BACKEND=mariadb`, V 1.37.2.1) |
| ✅ Done | Scanner → Risk draft (Greenbone/OpenVAS XML + PDF import, V 1.37.2.0) |
| ✅ Done | Policy Acknowledgement — staff confirm policies digitally with audit trail (V 1.37.2.0) |
| ✅ Done | Guidance CRUD — create, edit and upload own documentation (V 1.37.2.0) |
| ✅ Done | Guidance Search — cross-category full-text search with excerpt (V 1.37.2.0) |
| ✅ Done | Asset protection goals — CIA + authenticity (1–4), dependencies and BSI maximum-principle inheritance (V 1.37.2.0) |
| ✅ Done | NIS2 Art. 21 governance checklist (30 items) and Art. 23 reporting deadlines with automatic alerts (V 1.37.2.0) |
| ✅ Done | PostgreSQL backend (`STORAGE_BACKEND=pg`) — same Knex store layer as MariaDB, verified against a real PostgreSQL 17 instance incl. full `docker compose` path (V 1.37.5) |
| ✅ Done | ownCloud / Nextcloud integration — approved policies auto-published as PDF via WebDAV, optional favorite/public-link visibility, live-verified against a real NextcloudPi instance (#66, V 1.37.5.1) |
| ✅ Done | Docker image published to GitHub Container Registry after every release (`ghcr.io/coolstartnow/isms-builder`, `linux/amd64` + `linux/arm64`, signed build provenance) — contributed by @bucherfa (#71, V 1.40.0). Maintenance-effort trial: dropped again if it turns out to be more upkeep than expected. |
| ✅ Done | AI Policy Assistant — Ollama drafts content for any document type (Policy, Procedure, Risk Policy, SoA, Incident, Release) from title + type + language (#87, V 1.60.0) |
---
[Read more](https://github.com/coolstartnow/isms-builder)