Files

T

dillard d169b85f54 Fold email columns into init.sql, drop the admin/admin demo mention

Fresh installs (docker compose up -d --build, exactly what the README
tells a new self-hoster to run) never got the email/must_set_email/
self_registered_at columns added in migration 006 - only init.sql runs
automatically, migrations always need a manual step, and this one
never got folded into the base schema. A genuine first-time clone
would have broken immediately on login. Verified with a real fresh
volume: seed superadmin now correctly walks through forced password
change -> forced email set -> dashboard, no manual migration needed.

Also: qr.ensembia.com's README/About text still pointed at the
shared admin/admin demo login - replaced with a link to register.php
now that self-registration is live (the shared account has been
removed from the live instance).

2026-07-14 15:58:47 +02:00

3.4 KiB

Raw Blame History

Self-hosted, open-source QR code generator.

QRForge creates and manages static and dynamic QR codes from a clean, responsive control panel. It's a security-hardened, actively maintained fork of the original PHP Dynamic Qr code project by Giandonato Inverso, built on AdminLTE.

Try it free: qr.ensembia.com - fully functional OSS test instance. Register your own free account (email + a self-hosted CAPTCHA, no third-party service) - no shared demo login needed.
Commercial VIP edition: the ability to give sub-users the ability to create QR codes as well, from their own (sub)account. If you have a bigger organisation, having more users being able to create new QR codes delegates your workload. To fund our open-source project, a small fee (€49/year subscription per organisation ("tenant")) is requested for this. www.qrforge.eu.
Self-host it yourself: this repository, MIT-licensed.

Features

Dynamic QR codes with a database-backed URL shortener
- Create, edit, delete, enable/disable the redirect
- Download any time, bulk download/delete
- Batch-generate from a CSV file
16 static QR code types: Text, Email, Phone, SMS, WhatsApp, Skype, Location, vCard, Event/calendar, Bookmark, WiFi (incl. WPA3), PayPal, Bitcoin, 2FA, App Link (Android intent / universal links), Bluetooth
QR code styling: 6 export formats, foreground/background color, 4 precision levels, 10 sizes, optional label text below the code (custom font + size), optional icon shown above the code, save/load your own style presets
Address search (OpenStreetMap Nominatim) for Location QR codes
Built-in QR scanner (camera or image upload, decodes entirely client-side)
Installable as a PWA
Role-based access: super (full access + user management), admin (scoped to their own codes and sub-users), user (read-only, with optional view toggles set by an admin; per-account create rights are a VIP-edition feature, not available in this OSS version)
Dashboard with QR/scan statistics and a 7-day activity chart
CSRF protection, login rate limiting, session hardening, audit log
Docker Compose setup, both a dev image and a production Nginx + PHP-FPM image

What is included

PHP 8.4 application source
Database schema + migrations
Docker Compose files (dev and production)
CSS/JS assets

Setup with Docker Compose

Clone this repository.
Copy .env.example to .env and set a real DATABASE_PASSWORD / MYSQL_ROOT_PASSWORD.
Start the stack:
```
docker compose up -d --build
```
Open http://localhost and log in with superadmin / superadmin. You'll be required to set a new password on first login.

For a production deployment behind a reverse proxy, use docker-compose.prod.yml (Nginx + PHP-FPM) instead of the dev stack.

Credits

Originally forked from PHP Dynamic Qr code by Giandonato Inverso.
QR code rendering powered by chillerlan/php-qrcode.
Admin panel UI built on AdminLTE.

License

MIT - see LICENSE.