Repository navigation
Releases
1.0.6
βοΈ Release 1.0.6 β Docker Startup Fix & Total Value Formatting
Version 1.0.6 is a hotfix for 1.0.5. The 1.0.5 Docker image fails to start on a clean install, and this release fixes that. It also fixes the status dashboard's Total Value card, which ignored the currency position setting and formatted its amount by hand. Nothing else changes.
π³ Docker
- Image fails to start, fixed (#293, reported by firatkupeli): the 1.0.5 image crashes on boot with
ModuleNotFoundError: No module named 'packaging', gunicorn never starts, and the API returns 502 while the frontend loads. The cause: gunicorn loads its gevent worker class at startup, that class imports thepackagingmodule, but gunicorn declarespackagingonly in its optional "gevent" extra, and the requirements file installs plain gunicorn, so pip never installed it. The 1.0.4 image worked because it copied the builder's whole Python installation, which happened to carrypackagingalong; the smaller 1.0.5 image copies only the virtualenv, which exposed the missing pin.packagingis now pinned explicitly in the requirements file, and a regression test guards the pin so it cannot be pruned as unused. If you rolled back to 1.0.4, it is safe to update again.
π± Dashboard
- Total Value formatting, fixed (#294, reported by nesha14586): the Total Value card on the status dashboard formatted its amount by hand, with the currency symbol hardcoded in front, no spacing, and no thousands separators, ignoring the currency position setting. A user with Serbian Dinar and the symbol set to appear after the amount saw
Π΄ΠΈΠ½182591.00on the dashboard while their warranty entries correctly showed52790.00 Π΄ΠΈΠ½. The card now uses the same shared currency formatter as the warranty cards, honoring the position setting and the symbol spacing, and the shared formatter now adds locale thousands grouping everywhere, so the total reads182,591.00 Π΄ΠΈΠ½. The card also no longer forces the value onto one line, so large totals wrap inside the card instead of overflowing it.
Upgrading: back up (database + uploads volume), pull the new image, recreate the container. No migrations need manual steps. One carried-over note on database credentials (#221): DB_USER, DB_PASSWORD, DB_ADMIN_USER, and DB_ADMIN_PASSWORD should be set explicitly. The built-in defaults still work in 1.0.6 and startup logs a deprecation warning naming any of the four that are not set; the defaults will now be removed in 1.0.7, not 1.0.6 as originally announced, because this hotfix took the 1.0.6 slot. Both shipped compose files and the Unraid template already set all four.
1.0.5
βοΈ Release 1.0.5 β Product Photos, Duplicate Warranties & a Currency Fix
Version 1.0.5 is a quality-of-life release. Product photos get easier at every step: paste a URL, take the photo first, or capture it in the browser on mobile. Warranties can be duplicated instead of retyped, grid cards get a tidier overflow menu, and a mapping fix restores the Total Value card for everyone whose default currency is not the US dollar.
π· Product Photos
- Photo by URL (#207): the add and edit forms now accept a photo URL next to the upload and camera options. The server downloads the image once, verifies it really is an image (PNG, JPG, WebP or GIF), and stores it like an uploaded photo. Fetches are guarded: public http(s) addresses only, a size cap, a timeout, and a redirect limit. An uploaded file still wins when both are given.
- Photo comes first (#146): the photo upload now opens the Add Warranty form's Product tab, with its preview, so you can read the purchase date and serial number straight off the receipt photo as you type, instead of switching to a separate program.
- Mobile photo capture (#249, by canni): a new Take Photo button opens the camera directly on mobile, and the photo never enters the phone's gallery. Photos are downscaled in the browser to at most 2048px (JPEG) before upload, EXIF-orientation-safe, so multi-megabyte phone photos stop inflating storage and slowing uploads.
ποΈ Warranty Cards & Forms
- Duplicate warranty: every card gains a Duplicate action that opens the Add Warranty form prefilled with the original's details (name, purchase date or duration, price, vendor, model, serial numbers, warranty type, notes and tags). A manufacturer warranty and an extended warranty on the same product no longer need everything retyped. Photos, documents and claims are not copied.
- Grid view overflow menu: grid card headers carried six icon buttons next to the product name, and names truncated at 200px while the buttons took more room than the title. Claims and Edit stay visible; Archive, Void/Unvoid, Duplicate and Delete move into an overflow (β―) menu with text labels. The title cap is gone and names wrap instead of truncating. List and table views are unchanged.
- Other documents accept more than archives (#222): the Other Document picker in the add form and both edit modals only offered ZIP/RAR files, even though the server has always accepted PDFs and images there too. It now offers every type the server accepts (PDF, PNG, JPG, WebP, GIF, ZIP, RAR).
- Purchase Price tooltip (#223): the Purchase Price label in the add and edit forms now carries a help icon: the field is the price paid for the product, not the cost of the warranty, and a warranty included with a product simply takes the product's price.
- Claims blocked on voided warranties: a voided warranty's coverage is dead, but new claims could still be filed against it. Claim creation now returns a clear error, the claims view hides the Add Claim button for voided warranties and explains why, and claims recorded before the void stay fully editable. Un-voiding restores claim creation.
π Admin
- Provider column and editable email (#134): the admin Users list now shows how each account signs in (Local / OIDC), without exposing the raw OIDC subject. The Edit User dialog's email field, previously shown disabled, is now editable, with format and uniqueness validation, so an admin can fix a user's email without touching the database.
π± Dashboard
- Total Value no longer zero for most currencies (#289): the Total Value card sums only warranties in your default currency, but the symbol lookup behind it covered only 18 of the 89 supported currencies. Anyone whose default currency was outside that short list (reported for the Serbian Dinar) silently fell back to US dollars and saw a Total Value of 0.00 in their own symbol. The lookup is now completed from the supported-currency list in the dashboard statistics, warranty creation, CSV import, and the frontend: every symbol that belongs to exactly one supported currency resolves to it. Symbols shared by several currencies keep their established resolution.
π Security
- Stored XSS fixes: an internal audit found three places where stored, user-controlled values were rendered without safe encoding, and all three are fixed: usernames in the admin Users list (Settings), stored document URLs in warranty document links, and serial numbers in the legacy edit form shared by the main and status pages. Labels, icons, and layout are unchanged.
- Security dependency update: Authlib 1.9.1 β 1.9.2, carrying the upstream fix GHSA-f3fg-34g9-v7jx (ID-JAG access tokens limited to the scopes granted in the claim).
π³ Docker
- Smaller image: the Docker image is now 354 MB (down from 405 MB for 1.0.4 on amd64). Python dependencies install into a virtualenv in the builder and the runtime copies only that, supervisor is the pip package instead of the Debian package, and the entrypoint's database wait uses a short Python probe instead of the PostgreSQL client. Behaviour is unchanged: same base image, same startup flow.
- Clearer startup logs: the container log opens with the running version and a short configuration summary (database host, port, name and user, nginx on or off, upload limit, memory mode, frontend URL), the database wait reports progress and fails with the host and port it tried, step failures stop startup with one clear line, and nginx errors now appear in
docker logs. A Warracker banner prints once the app passes its health check. No passwords are ever printed. Docker/compose file fixed: the compose file in the Docker folder shipped with a broken environment line that made the whole file invalid YAML, and its SECRET_KEY line read a variable name no shipped example defines, so a documented SECRET_KEY was silently ignored. Both are fixed; the file now parses and honors${SECRET_KEY:-}like the root compose file.
π Localization
- No more "undefined" labels: form labels built in the first moments after page load could render the literal text "undefined" while translations were still loading. Every translation lookup now falls back to the English string when the translation is not ready yet, across the form, list and component scripts.
π§ Dependencies & Runtime
- gunicorn 24.1.1 β 26.2.0 and gevent 24.11.1 β 26.9.0 (the new gevent ships Python 3.15 wheels, ending the from-source compile that slowed multi-arch builds), python-dateutil 2.9.0 β 3.0.0, setuptools 84.0.0 β 84.2.1, and the Python 3.15 slim base image digest refreshed.
π§ͺ Project
- The test suite grows to 64 tests in CI, including new regression coverage for the currency mapping, the stored-XSS fixes, and the Docker folder compose file.
- The README screenshots are refreshed for 1.0.5, including a dark-mode set: all five warranty statuses on one screen, product photos and documents on every card, and multiple tags per card. The wiki User Guide is updated to match, and its CSV import field reference is corrected (flexible date parsing, no hidden caps on warranty months or days).
Upgrading: back up (database + uploads volume), pull the new image, recreate the container. No migrations need manual steps. One note on database credentials (#221): DB_USER, DB_PASSWORD, DB_ADMIN_USER, and DB_ADMIN_PASSWORD should now be set explicitly. The built-in defaults still work in 1.0.5, but startup logs a deprecation warning naming any of the four that are not set, and the defaults will be removed in 1.0.6, when all four become required. Both shipped compose files and the Unraid template already set all four, so installs following the shipped templates only need to check for the warning.
πΈ Screenshots
Home page, grid view: every warranty status on one screen, with a product photo, documents, and multiple tags on every card:
Grid view card menu: Archive, Void, Duplicate and Delete in the overflow menu, with text labels:
Status dashboard: summary cards including Total Value and Void:
1.0.4
βοΈ Release 1.0.4 β Warranty Claims with Documents, Void Status & Paperless Security
Version 1.0.4 is a feature and hardening release. Claims grow up: they can now carry documents end-to-end. Warranties can be marked void when their conditions are broken. And a full access-control pass over the Paperless-ngx integration closes two responsibly disclosed security issues, alongside a stored-XSS fix in the Paperless browser.
π Warranty Claims & Documents (#148)
- Claims can now carry documents β approval or rejection letters, photos of the defect, repair invoices, and similar evidence.
- Each claim shows a Documents section in the claims view: attach a file directly, or upload it to Paperless-ngx and link it, then view or remove it from the same place.
- Access follows the warranty's other documents: owner and admins only, never shared through global view.
- Deleting a claim or its warranty removes the attached local files from disk; Paperless documents are unlinked, never deleted from Paperless.
π« Void Warranty Status (#250)
- A warranty can be manually marked void β physical damage, unauthorized repairs, broken seals β without deleting the item or changing its expiration date.
- Voided warranties stay visible with a purple Void status, a matching filter, and their own count card on the status dashboard.
- They are excluded from the Total Value card, active/expired/expiring counts, expiration timelines, and expiry notification emails. Voiding is reversible.
π Security
- Paperless-ngx document access control (GHSA-fv62-3hrm-gf83 / GHSA-3h89-rqfj-5674): Warracker connects to Paperless with one shared API token, and any signed-in user could list every document in the instance, link another user's document to their own warranty or claim, and download it β the link itself was treated as proof of ownership. Warracker now tracks which user owns each Paperless document (recorded on upload or first link; existing links backfilled by migration). Search is scoped per user, linking someone else's document is rejected everywhere (warranty create/update, search-and-link, claim documents), downloads follow ownership plus the usual global-view rules, the Paperless debug endpoints are admin-only, and claim document metadata is no longer shown to global-view readers. Reported by 0xnu11ptr, and by Brandon Tarr (VulnCheck).
- Stored XSS via Paperless document titles: the Paperless document browser rendered titles, correspondents, and tag names without escaping, so a crafted document title executed in the browser of anyone who opened it β admins included. These fields are now HTML-escaped.
- Known default JWT secret removed from the compose files: both shipped compose files defaulted
SECRET_KEYto a fixed value printed in this public repository β an install that never set its own key signed login tokens with a secret anyone could read. The default is now empty, which activates the backend's generate-and-persist behavior.
π Paperless-ngx
- Document titles use the product name (#147): uploads are now titled " - Invoice", " - Manual", or " - Claim document" instead of "Warracker invoice - ".
- Browse/link fixed for non-admin users: the Paperless sections of the warranty forms were hidden from non-admins because the enabled flag was read from an admin-only endpoint. A new signed-in status endpoint exposes only the flag β never the Paperless URL or token.
π OIDC
- Skip the login screen in OIDC-only mode (#186): a new admin setting (or
OIDC_SKIP_LOGIN_SCREEN) sends users straight to the identity provider. If the provider returns an error, the login screen reappears with the error β the redirect never loops. - First OIDC user now becomes owner (PR #254): the first OIDC sign-in previously granted admin but not owner; startup recovery and admin-group sync could also leave an instance ownerless or demote the owner. All three paths now keep a proper owner.
π Dashboard
- Total Value card fixed: since 1.0.3 it silently dropped every warranty with no currency recorded (older entries, imports). Those now count as your default currency; warranties in a different explicit currency are still excluded, as intended. The card's tooltip explains the calculation (all 20 locales).
π Localization
- All 20 new 1.0.4 interface strings are translated into the 19 non-English locales (machine translation β native review welcome), including corrections to the void status wording in 14 locales where it read as "empty" instead of "voided".
π§ Dependencies & Runtime
- flask-cors 4.0.2 β 6.0.5, fixing four published CORS policy-bypass vulnerabilities (CVE-2024-6221, CVE-2024-6866, CVE-2024-6839, CVE-2024-6844).
- Authlib 1.9.1, PyJWT 2.15.1, setuptools 84.0.0.
- The Docker base image moves from Python 3.13 to Python 3.15 (Debian 13 slim).
π§ͺ Project
- A test suite and CI now run on every pull request and push to main (36 tests covering the Paperless security rules, file access control, statistics, and validation), so the 1.0.3/1.0.4 security fixes stay fixed.
- The wiki launched: full user guide, configuration, backup/restore, reverse proxy (including Cloudflare Tunnel), troubleshooting with error numbers, per-page contents, and a roadmap.
- Claim documents UI: the Attach button now sizes to its content (it previously stretched across the documents section) and wraps correctly on mobile.
Upgrading: back up (database + uploads volume), pull the new image, recreate the container. Migrations (claim documents table, void column, Paperless ownership) run automatically on startup. If you run the shipped compose files and never set SECRET_KEY, this release changes your key handling: a random key is generated and persisted on first start, which signs out existing sessions once β your data is unaffected.
πΈ Screenshots
Status dashboard β every warranty state at a glance (Void included):
Claim documents β files attached to a claim, local or in Paperless-ngx:
1.0.3
βοΈ Release 1.0.3 β Security Fixes, Dashboard Upgrades & CSV Round-Trip
Version 1.0.3 is a hardening and polish release. It closes two responsibly disclosed security vulnerabilities, adds the Total Value and Archived dashboard cards, makes CSV export/import a true round-trip, and fixes dozens of bugs found through a 14-day QA sweep of every page, API endpoint, and edge case.
π Security
- Broken access control in
/api/files/(High): the legacy file route served any uploaded document to any logged-in user with no ownership check, ignoring the admin's document-sharing setting. Both file routes now share a single authorization helper (owner, admin, or global-view setting), and/api/files/gained the path-traversal guard it was missing. Reported by humidnhefty (Malik Abdullah, Lupine Security). - Stored XSS via warranty fields: warranty cards rendered user-controlled fields into
innerHTMLwithout escaping, so a malicious value (e.g. via CSV import) executed JavaScript in every viewer's browser. All user-controlled fields are now HTML-escaped, andproduct_urllinks rejectjavascript:/data:/vbscript:schemes. Reported by humidnhefty and the CSCE 413 (Texas A&M University) vulnerability-research team. - Passwords over 72 bytes no longer crash login/registration/password change (bcrypt limit) β they now return a clean HTTP 400.
Self-hosters: if you cannot update immediately, block /api/files/ at your reverse proxy β the UI only uses /api/secure-file/.
π Dashboard
- Total Value card (#192): shows the sum of purchase prices for non-archived warranties, in your default currency only (no cross-currency mixing). Clicking the card opens a tooltip explaining the calculation.
- Archived card: archived warranties are now excluded from all dashboard counts and shown in their own card.
- Status page CSV export: the Export button now downloads a CSV of the currently displayed (filtered and sorted) warranties instead of showing a "not implemented" toast.
- Global view: the expiration timeline now includes other users' warranties, matching the rest of the dashboard.
- Expiry-day consistency: a warranty expiring today is now counted the same way by statistics, the UI, and notifications β still valid.
π CSV Import/Export
- True round-trip: exports now include Notes, Currency, ModelNumber, and WarrantyType β re-importing an export no longer loses data.
- Tags and serial numbers containing commas survive the round-trip (JSON-encoded cells, with fallback for legacy files).
- Real-world files handled: BOM/cased/whitespace headers (#236), short rows, overlong product names, and oversized fields now produce clean per-row errors instead of HTTP 500s or leaked database errors.
π± Mobile & Frontend
- Font Awesome is served locally, so icons work on offline/restricted networks.
- Expired sessions redirect to login instead of leaving a broken UI (#225).
- Frontend JavaScript refactored into ES modules; service worker no longer caches JS indefinitely, so updates reach returning users.
π More Fixes
- Uploads: same-second uploads of the same filename no longer overwrite each other; oversized uploads return HTTP 413 with the configured limit.
- Downloads: missing files return 404 (not 500); local downloads no longer return empty files.
- Notifications: expiry emails notify once per threshold instead of repeating daily (#188).
- Paperless-ngx: full tag pagination (#255), "Test Connection" tests unsaved values, uploads link documents reliably.
- Reliability: Docker health check now verifies the backend (#239), migrations handle mixed-case
DB_USER(#187),DATABASE_URLis honored (#108), OIDC redirects keep nonstandard ports (#238), password reset no longer crashes (#216), nginx no longer logs at debug level (#211). - i18n: 66 missing English keys added; all 19 non-English locales fully translated (machine translation β native-speaker review welcome).
- Currency preference now applies to warranty cards; NOK/DKK no longer revert to SEK (#205); long labels no longer overflow cards (#212); invisible toasts no longer block clicks (#197).
π Credits
Security reports: Malik Abdullah (Lupine Security) and humidnhefty + the CSCE 413 Texas A&M team. Issue reports and testing: the Warracker community β thank you.
Full details in the CHANGELOG.
1.0.2
βοΈ Release 1.0.2 β CSV Import Enhancements & Permission Handling Upgrade
Version 1.0.2 introduces major improvements to the CSV import process and backend permission management, enhancing both data flexibility and system reliability.
This release focuses on better handling of real-world import scenarios, improved error tolerance, and more robust permission management for Docker-based deployments.
π CSV Import Improvements
π Exact Expiration Date Support
- Added support for a precise
ExpirationDatefield in CSV imports. - Automatically used when duration fields (
WarrantyDurationYears,WarrantyDurationMonths,WarrantyDurationDays) are empty or zero, andIsLifetimeisFALSE. - Documentation updated to reflect the new field and its conditional logic.
- Modified files:
backend/warranties_routes.py,README.md
β Result: Enables direct import of warranties with specific expiration dates β improving data accuracy and reducing manual adjustments.
βοΈ Partial Commits with Per-Row Error Reporting
- CSV imports now commit successful rows even when others fail.
- The API response includes detailed per-row error messages.
- Returns
200for partial success and400only if all rows fail. - Modified file:
backend/warranties_routes.py
β Result: Easier troubleshooting and improved reliability for large or mixed-quality CSV files.
π Automatic Duplicate Name Suffixing
- If a
ProductNamealready exists for the samePurchaseDate(in the database or within the same file), the importer now automatically renames it toName (1),Name (2), etc. - Prevents hard failures on legitimate, duplicate product entries with unique serials or metadata.
- Modified file:
backend/warranties_routes.py
β Result: Seamless import of multiple products sharing identical names and purchase dates.
π§° Permission Handling Enhancements
- Updated entrypoint logs to clearly indicate permission fixing:
"Fixing permissions (database and upload folder)". - Refactored the logic into
fix_upload_folder_permissions()andfix_database_permissions()for clearer scope and maintainability. - Ensures recursive ownership of uploads to
warracker:warracker(uid:999, gid:999), with improved logging and connection retry handling. - Modified files:
Docker/entrypoint.sh,backend/fix_permissions.py
β Result: More reliable startup and consistent file/database permissions in containerized environments.
π‘ Credit: Enhancement contributed by @Erwan-loot
π Reference: PR #180
π§ Upgrade Notes
- No database migrations required.
- Existing CSV templates remain valid; optional new
ExpirationDatefield can be added. - Recommended for all users importing CSV data or running in Docker environments.
This 1.0.2 release enhances import flexibility, error handling, and permission robustness, ensuring a smoother and more reliable experience for all Warracker deployments.
1.0.1
π©Ή Hotfix 1.0.1 β PostgreSQL Privilege Handling & Startup Stability
Version 1.0.1 delivers a targeted hotfix addressing a container startup issue affecting environments with restricted PostgreSQL privileges.
This patch ensures the service can start reliably even without elevated database permissions , no feature or schema changes introduced.
β οΈ Note: This hotfix is only required for users deploying in restricted or limited-privilege PostgreSQL setups.
Standard installations and environments with full DB privileges are unaffected.
π PostgreSQL Startup Loop Fix
β Stable Startup in Restricted Environments
-
Fixed a container startup loop caused by missing privileges in the PostgreSQL startup script.
-
Wrapped the
ALTER ROLE ... CREATEROLEcommand in a safeDOblock with exception handling.- If insufficient privileges are detected, a NOTICE is logged and startup continues normally.
-
No functional or schema changes β only improved robustness during initialization.
-
Modified file:
backend/fix_permissions.sql
β Result: Reliable container startup even in environments without elevated database roles.
π§ Upgrade Notes
- No migrations or configuration changes are needed.
- Only applies if your deployment runs with restricted PostgreSQL roles.
- If you previously experienced a container restart loop during startup, upgrading to this version will resolve the issue.
This 1.0.1 Hotfix improves startup reliability for deployments with restricted database permissions β ensuring smooth operation without requiring elevated PostgreSQL privileges.
1.0.0
π Release 1.0.0 β Renovate Automation, Audit Trails, and Global Enhancements
Version 1.0.0 marks a major milestone, our 51st release, and the moment weβre officially taking Warracker out of beta π.
This release delivers automated dependency management, a robust admin audit trail, comprehensive multilingual support, and major Docker optimizations cutting the image size by half while improving security and maintainability.
β οΈ Important: It's advised that before upgrading, to please back up your database and configuration.
After updating, clear or refresh your browser data to ensure all new assets load correctly.
π€ Automated Dependency Management with Renovate
β Smarter, Safer Dependency Upkeep
-
Integrated Renovate Bot for continuous dependency maintenance.
-
Intelligent grouping for Debian packages, Python libraries, and GitHub Actions.
-
Automated weekly checks (runs every Monday at midnight).
-
Includes:
- Merge confidence badges
- Version pinning
- OpenSSF Scorecard checks
- Safe handling of major upgrades
β Result: Secure, low-maintenance, and fully automated dependency management.
- Contributed by @Erwan-loot
π§Ύ Administrator Audit Trail
β Complete Administrative Transparency
-
Added admin-only audit logging for key events:
- Site setting changes (with secrets masked)
- User updates and deletions
-
New
GET /api/admin/audit-trailendpoint. -
Frontend: dedicated Audit Trail section under Settings for admins.
β Result: Full visibility into critical changes with safe and structured logs.
π·οΈ New βModel Numberβ Field for Warranties
β Richer Product Tracking
- Added optional Model Number field to all warranty records.
- Displayed in warranty cards and modals across all views (Home, Global, Status).
- Search and statistics updated to include
model_number.
β Result: Easier product identification and traceability.
π Global Language Expansion
β Two New Languages + Complete Coverage
- Polish (
pl) and Hebrew (he) added with full translation coverage. - Hebrew includes full RTL layout support.
- Completed warranty claim modal translations across all locales (18+ languages).
- Added localized Reddit Community link to the About page.
β Result: True global accessibility with complete multilingual support.
Credits:
- Polish by @GaikMarcin
- Hebrew by @ngfblog
π³ Docker & Infrastructure Upgrades
β Streamlined, Secure, and Smaller Than Ever
-
Refactored Dockerfile with multi-stage builds, reducing image size by ~50%.
-
Added dedicated Docker setup:
entrypoint.sh,nginx-wrapper.sh, andsupervisord.conf
-
Enforced LF endings for scripts, pinned dependencies, and applied Docker security best practices.
β Result: Faster builds, leaner deployments, and safer runtime environments.
Contributed by @Erwan-loot
βοΈ Core Enhancements
β Reliability and Maintainability
- Refactored OIDC handler and database layer for cleaner code and stability.
- Enhanced frontend cache busting to ensure clients always load the latest files.
- PWA service worker now refreshes instantly (
skipWaiting()+clients.claim()).
β Result: Faster load times, improved stability, and reduced caching issues.
π§ Smarter Search and Dashboard Behavior
β Model-Aware Search
- Search across Home and Status pages now matches by Model Number.
- Updated search placeholders and backend filters.
β Archived Status Support
- Added Archived filter to the Status dashboard.
- Archived warranties now appear under βAllβ and βArchivedβ views with neutral styling.
β Result: Clearer warranty organization and smoother search experience.
π§© UI & UX Fixes
- Global warranties now display correctly across users, including archived items.
- Model Number now appears correctly in all locales and views.
- Small-screen optimizations: Tabs and labels adapt below 430 px.
- Document links: External URLs now visible even without notes/files.
- Chrome scrollbar fix: Removed overflow-causing width hacks.
β Result: Cleaner, consistent, and mobile-friendly interface across browsers.
π¦ Dependency Upgrades
Major updates:
- Python β 3.14
- gevent β 25.9.1
- flask-cors β 6.0.1
- Font Awesome β 7.x
- postgresql-client β 17
Minor updates: Flask 3.1.2, Werkzeug 3.1.3, Psycopg2 2.9.11, PyJWT 2.10.1, APScheduler 3.11.0, Authlib 1.6.5, and more.
β Result: Updated dependencies with improved speed, security, and compatibility.
π§ Migration Notes
-
Migration 047 adds
model_numbercolumn to warranties. -
Migration 048 creates
audit_logtable for admin trail. -
Migration 049β050 adds
plandheto supported language constraints. -
Rebuild required: Rebuild Docker image for Python 3.14.
-
Verify:
- flask-cors v6 compatibility
- Font Awesome 7 rendering
- PostgreSQL 17 client connection
π Credits
- Renovate integration and Docker optimization by @Erwan-loot
- Polish translation by @GaikMarcin
- Hebrew translation by @ngfblog
This 1.0.0 release makes Warracker production-ready, leaner, faster, multilingual, and more maintainable than ever.
While weβre proud to move out of beta, please back up before upgrading and refresh your browser data after the update to ensure a smooth transition.
β¨ Welcome to Warracker 1.0 , Stable, global, and future-ready.
0.10.1.14-beta
π¦ Release 0.10.1.14 β Persistent Filters, Smarter OIDC, and Mobile Navigation
This release enhances filter persistence, OIDC integration, and mobile navigation, delivering smoother usability across devices and views. Filters now sync via API for cross-device consistency, OIDC gains advanced configuration and admin support, and mobile users benefit from a redesigned hamburger menu. Numerous fixes improve UI consistency, authentication reliability, and tablet layouts.
π Persistent Filters and Smart Sync
β Cross-View and Cross-Device Consistency
- Filters (Status, Tag, Vendor, Type, Search, Sort) now persist across navigation and reloads.
- Synced to API
saved_filterswhen authenticated for multi-device continuity. - Skips API writes on initial load to prevent unnecessary saves.
- View switching now reapplies filters seamlessly via
applyFilters(). - Restores saved Search input and clears filters correctly with βReset.β
β Result: Users enjoy consistent filtering behavior across sessions and devices.
π Smarter OIDC Integration and Secure Configuration
β Enhanced OIDC Features
- Added admin group support for OIDC-managed permissions.
- Synchronized key user attributes during login.
- OIDC-managed settings are hidden or disabled to prevent conflicts.
- Updated authentication flow for PyJWT 2.10 compatibility.
- Replaced deprecated
utcnow()calls with timezone-safe alternatives.
β Result: Stronger identity integration, improved reliability, and future-proofed authentication.
π± Modern Mobile Navigation
β New Slide-Out Hamburger Menu
- Introduced responsive slide-out mobile menu (β€768px) with overlay.
- Dynamically clones navigation and auth links for unified behavior.
- Locks body scroll while open and closes on overlay or link click.
- Tablet (769β820px) now shows branded logo/title on login and refined Status card layout.
- Mobile UX refinement hides redundant user menu button and improves clarity.
β Result: A cohesive, intuitive navigation experience on all screen sizes.
π§© UI/UX Enhancements
- Entire user menu entry now clickable for easier access.
- Archived warranties now appear correctly under βAllβ with proper styling.
- Non-archived filters correctly exclude archived items.
- Re-merge behavior ensures archived items reload correctly after switching views.
β Result: Clearer UI, fewer inconsistencies, and smoother workflow transitions.
π Key Fixes
- Fixed OIDC client reload lifecycle and userinfo source handling.
- Resolved menu toggle issues on Settings page with dedicated script.
- Restored standalone Login page (removed header/menu overlap).
- Corrected Login button label and introduced
auth.login_titletranslation key. - Improved tablet Status layout for clearer summary grouping.
β Result: Polished authentication flow and consistent responsive layouts.
π‘ Configuration Improvements
- Added configurable upload folder and secure runtime secret generation.
- Supported reading secrets from environment
*_FILEpaths.
β Result: More flexible and secure deployment options.
π Credit
OIDC and configuration improvements contributed by @tecosaur in PR #138.
Modified Files:
frontend/script.js, frontend/index.html, frontend/style.css, frontend/mobile-header.css, frontend/mobile-menu.js,
backend/auth_utils.py, backend/oidc_handler.py, backend/app.py, backend/config.py,
backend/auth_routes.py, backend/migrations/046_add_saved_filters_column.sql, and others.
This update makes Warracker more consistent, secure, and user-friendly , ensuring filters, settings, and navigation work effortlessly across sessions, devices, and environments. π
0.10.1.13-beta
π¦ Release 0.10.1.13 β Smarter UI, Multilingual Reach, and Archival Power
This release introduces comprehensive Turkish translations, a non-destructive warranty archive system, and major UI/UX improvements across login, filters, sorting, and tag management. Users benefit from cleaner layouts, session-persistent settings, and seamless multi-device usability while maintaining compatibility with existing workflows.
πΉπ· Full Turkish Language Support
β Complete Translations Across Pages
- Added Turkish (
tr) translation file with comprehensive UI, message, and system text coverage. - Applied translations consistently across Index, About, Status, and Settings pages.
β Result: Turkish-speaking users now enjoy a fully localized Warracker experience.
ποΈ Non-Destructive Warranty Archiving
β Safe and Reversible Archival
-
Added ability to archive warranties without deletion (
archived_attimestamp). -
New API endpoints:
GET /api/warranties/archivedPATCH /api/warranties/{id}/archive
-
Archived warranties hidden by default but retrievable with filter.
-
Neutral gray styling to distinguish archived items.
β Result: Users can clean up views without losing historical warranty data.
π¨ Modernized User Interface
β Refined Login Page
- Clean two-column layout with branding showcase and improved form controls.
- Branded SSO buttons, dark/light theme compatibility, and mobile logo/title.
β Smarter Filters, Sorting, and Data Management
- Unified filter/sort into popover panels for decluttered UI.
- Session persistence with localStorage for filters and sort settings.
- Consolidated Import/Export into a single βDataβ menu.
β Modern Tag Management
- Inline editing and immediate persistence of tag changes.
- Live UI refresh for tags across modals, filters, and warranty cards.
- Modernized modal design with responsive, theme-aware styles.
β Mobile Enhancements
- Three-row layout for improved usability on narrow screens.
- Compact filter/sort labels (icons-only under 425px).
β Result: A cleaner, faster, and more consistent UI on desktop and mobile.
π§ Key Fixes and Improvements
- Fixed dark mode text, caret visibility, and navigation consistency.
- Corrected i18n safety with proper mapping of translation keys.
- Added missing translations across multiple locales.
- Fixed JavaScript error with duplicate
isArchivedViewdeclaration. - Preserved alignment and branding for SSO buttons.
- Improved scrolling and spacing for mobile usability.
β Result: Smoother user experience, fewer errors, and improved theme consistency.
Modified Files:
locales/tr/translation.jsonfrontend/login.html,frontend/style.css,frontend/index.html,frontend/script.js,frontend/mobile-header.css,frontend/header-fix.cssbackend/migrations/045_add_archived_at_to_warranties.sql,backend/warranties_routes.py,backend/notifications.py- Multiple locale files (
locales/*.json)
This update delivers a modernized UI, robust archiving, and expanded language support, ensuring Warracker is more accessible, intuitive, and powerful than ever. π
π· Screenshots

0.10.1.12-beta
π¦ Release 0.10.1.12 β Reliable Uploads, Secure Access, Stronger Deployments
This release focuses on fixing critical Paperless-ngx integration issues, restoring full functionality for non-Docker setups, and improving production stability and repository management. Users can now upload documents reliably with Paperless-ngx, connect securely with 2FA, and enjoy smoother deployments across all environments.
π Reliable Paperless-ngx Integration
β Accurate Duplicate Detection
- Fixed critical bug where all new uploads were flagged as duplicates due to an incorrect API parameter.
- Corrected checksum matching ensures only true duplicates are blocked.
- Users can now upload new documents without interference.
- Credit: Fix contributed by @sjafferali in PR #127.
β Result: New files upload correctly, while duplicate detection works as intended.
β Secure Token Authentication with 2FA
- Fixed API token failures when Paperless-ngx Two-Factor Authentication (2FA) was enabled.
- Implemented pure token-based authentication with improved error handling.
- Backward compatible for setups without 2FA.
β Result: Users with 2FA enabled can securely connect without losing functionality.
π¨ Restored Assets for Non-Docker Installs
β Full Status Page and i18n Support
- Restored missing i18next JavaScript libraries that were excluded by .gitignore.
- Updated service worker cache configuration and forced refresh with a new version.
β Result: Non-Docker installations now load the status page and internationalization features without errors.
β‘ Stronger Production Deployments
β Database Driver Optimization
- Replaced
psycopg2-binarywithpsycopg2for production-grade stability and performance. - Ensures compatibility with system libraries during deployment.
β Result: More reliable PostgreSQL connectivity in production.
β Repository Library Tracking
- Updated
.gitignoreto include the/libdirectory for essential library files. - Ensures dependencies are properly tracked and available in all environments.
β Result: Cleaner repository management and consistent builds.
Modified Files:
backend/paperless_handler.pybackend/file_routes.pybackend/requirements.txtfrontend/sw.js.gitignore
This update delivers reliable uploads, secure API integration, and stronger production stability, ensuring Warracker works seamlessly across both Docker and non-Docker environments. π



