Skip to content

Fileament v1.3.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 04 Aug 18:14
v1.3.0
9032688
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Fileament v1.3.0 adds full-installation backup and restore, faster concurrent uploads with clearer grouped-variant management, and a more complete sharing and library-management experience. This release also strengthens destructive-action safeguards, collection cover rendering, and thumbnail consistency when variants are removed.

Warning

Fileament is still in the early stages of development. Back up your /data volume and review the release notes before updating.

Highlights

Full backup and restore

Owners can now create a versioned .fileament backup from Settings and restore an installation through a staged, validated replacement flow.

  • Backups contain a consistent SQLite snapshot and the persistent models, images, thumbnails, sidecars, collections, settings, owner password hash, and share links needed to restore the installation.
  • Restore inspection rejects incompatible, corrupt, unsafe, or incomplete archives before live data changes.
  • Applying a restore creates a pre-restore safety backup, pauses writes and thumbnail workers, invalidates login sessions, and automatically rolls back interrupted or failed activation.

Faster uploads and better variant management

The upload queue now runs up to three model uploads concurrently without sacrificing durable sidecar consistency or collection ordering.

  • Grouped uploads show each variant's filename, format, size, rendering state, and generated thumbnail.
  • Persisted variants can be removed individually through a confirmation flow.
  • Card-thumbnail source tracking prevents deleted variants from leaving stale model previews, including after thumbnail renderer updates.

Safer library and sharing workflows

Common catalog and sharing actions now provide clearer state and stronger safeguards.

  • Collection cards render their selected model covers and refresh when thumbnail state changes.
  • Model, variant, image, collection, collection-membership, and share-link removals use accessible confirmation flows appropriate to their impact.
  • Share management includes copy-ready absolute URLs, target names, lifecycle status, optional non-expiring links, and view counts based only on successful public-page loads.

Upgrade notes

No database schema migration is required for v1.3.0, and existing /data volumes remain compatible. Fileament creates backup and restore workspace under /data; keep enough free space for an uploaded backup, the replacement data, and a pre-restore safety backup when using restore.

A new optional FILEAMENT_MAX_BACKUP_MB environment variable limits both uploaded backup size and expanded backup size. It defaults to 8192 MiB, so existing deployments do not need a configuration change. FILEAMENT_BASE_URL should contain only Fileament's public HTTP(S) origin; path components are ignored because subpath mounting is not supported.

Before upgrading from v1.2.2, stop Fileament and make an infrastructure-level copy of the complete /data volume. The in-app .fileament backup feature is available after the upgrade. Treat every backup as sensitive because it includes the owner password hash, settings, and share links. A successful restore invalidates current login sessions and requires the owner password stored in the restored backup.

docker pull ghcr.io/techhuttv/fileament:1.3.0

If you use Docker Compose, update the image tag and recreate the service:

docker compose pull
docker compose up -d

Changes by pull request

feat: add full backup and restore by @TechHutTV

  • Added owner-only creation and download of versioned full-installation backups.
  • Added staged restore inspection, compatibility and integrity validation, explicit RESTORE confirmation, session invalidation, safety backups, and crash-aware rollback.
  • Coordinated SQLite, persistent files, active requests, SSE clients, and thumbnail workers around one restore consistency boundary.

fix: render selected collection covers by @TechHutTV

  • Added selected cover-model thumbnails to collection summaries and cards while retaining the folder fallback.
  • Refreshes collection covers when thumbnail generation or model thumbnail selection changes.

fix: confirm destructive actions by @TechHutTV

  • Added accessible, item-specific confirmation dialogs for destructive model, variant, image, and collection actions.
  • Added lighter confirmation for collection membership removal and share revocation, with keyboard focus management and pending/error states.

feat: complete share link management by @TechHutTV

  • Added copy-ready absolute share URLs, target names, lifecycle metadata, statuses, and optional non-expiring links.
  • Added clipboard feedback and public-page revalidation after expiration or revocation.
  • Changed view counting so only successful public-page metadata loads count, not thumbnail, mesh, image, file, status, focus, or reconnect requests.

fix: support concurrent upload queue by @TechHutTV

  • Runs up to three browser uploads concurrently while serializing durable model and collection sidecar persistence.
  • Preserves original collection ordering even when uploads finish out of order.
  • Added grouped-variant previews and confirmed per-file removal, including durable card-thumbnail source tracking and cleanup for deleted variants.

Full changelog: v1.2.2...v1.3.0

Assets 2
Loading