Fileament v1.3.0

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

Fileament v1.2.2

This patch release contains focused fixes and improvements.

Container image

docker pull ghcr.io/techhuttv/fileament:1.2.2

Published for linux/amd64 and linux/arm64. The latest tag points to this stable release.

Fixes and improvements

• fix: polish settings and share actions by @TechHutTV in #15

Full changelog: v1.2.1...v1.2.2

Fileament v1.2.1

This patch release contains focused fixes and improvements.

Container image

docker pull ghcr.io/techhuttv/fileament:1.2.1

Published for linux/amd64 and linux/arm64. The latest tag points to this stable release.

Fixes and improvements

• Require upload organization selection by @TechHutTV in #10
• feat: add visual variant picker by @TechHutTV in #11
• fix: correct viewer zoom controls by @TechHutTV in #12
• feat: add file variation renaming by @TechHutTV in #13
• ci: standardize release notes by @TechHutTV in #14

Full changelog: v1.2.0...v1.2.1

Fileament v1.2.0

Fileament v1.2.0

Fileament 1.2.0 makes it easier to organize related model files, improves the browser viewer, and cleans up how release artifacts are built and distributed.

Warning

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

Highlights

Organize models while uploading

Uploads can now be assigned to a collection before they finish. Fileament keeps the collection state in sync if an upload is canceled or removed.

When several loose STL, OBJ, or 3MF files belong to the same model, select One model with variants to create a single library entry. Grouped uploads are validated and persisted together, so an invalid variant does not leave behind a partial model. ZIP archives continue to create their own bundled models.

Better model details and viewer controls

• Download the currently selected variant directly from the model detail sidebar.
• Zoom the 3D viewer in or out and reset the camera with compact viewer controls.
• Choose a model color for STL and OBJ previews.
• Keep the selected viewer color in browser-local storage, with safe fallback behavior when storage is unavailable.
• Use consistent variant terminology across uploads, model details, and public shares.

Cleaner standalone releases

The production container still ships Fileament as one standalone Go executable with the complete web interface embedded. Generated Vite bundles are no longer stored in Git. Production Docker builds stage the generated frontend inside the builder and embed it into the release binary.

This keeps source checkouts cleaner while preserving the single-binary production artifact.

Public documentation and AGPL licensing

• Reworked the README around installation, configuration, backups, updates, security, and everyday use.
• Added a repository-wide AGENTS.md guide for contributors and coding agents.
• Licensed Fileament under AGPL-3.0-only.

Upgrade notes

Official container users do not need a database schema migration or production configuration change. Existing /data volumes remain compatible.

Untagged binaries built directly from source now load the frontend from web/dist by default. Run npm run build from web/ before starting one, or set FILEAMENT_WEB_DIR to another directory containing the built frontend. Official production images embed the frontend and do not use this setting.

Back up the complete /data volume before updating. The versioned image is available for linux/amd64 and linux/arm64:

docker pull ghcr.io/techhuttv/fileament:1.2.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: refine model library and viewer UX by @TechHutTV

• Added optional collection assignment for queued uploads, including cleanup when an upload is canceled.
• Added a download action for the currently selected model variant.
• Added compact zoom and reset controls to the 3D viewer.
• Added browser-local model color presets for STL and OBJ previews.
• Hardened upload cleanup and viewer preferences when browser storage is unavailable.

feat: add grouped model uploads by @TechHutTV

• Added explicit One model with variants organization for multiple loose mesh files.
• Preserved separate-model defaults for loose files and existing ZIP bundle behavior.
• Added atomic grouped-model creation with staged validation and rollback on invalid variants.
• Prevented duplicate variant filenames from overwriting one another.
• Standardized variant terminology across uploads, model details, and public shares.

Keep generated frontend assets out of Git by @TechHutTV

• Removed generated Vite bundles from source control.
• Added separate external-development and embedded-release frontend providers.
• Preserved the standalone production binary by staging generated assets only inside the Docker builder.
• Added CI protection against recommitting generated frontend output.

Add public README and AGPL license by @TechHutTV

• Added a prominent early-development and upgrade warning.
• Reworked the README around public installation, configuration, backups, updates, security, and source builds.
• Added the repository-wide AGENTS.md contributor guide.
• Licensed Fileament under AGPL-3.0-only with the canonical GNU license text.

Full changelog: v1.1.0...v1.2.0

Fileament v1.1.0

Container image

docker pull ghcr.io/TechHutTV/fileament:1.1.0

Published for linux/amd64 and linux/arm64. The latest tag points to this stable release.

What's Changed

• feat: improve uploads and model previews by @TechHutTV in #5

Full Changelog: v1.0.0...v1.1.0

Fileament v1.0.0

Container image

docker pull ghcr.io/TechHutTV/fileament:1.0.0

Published for linux/amd64 and linux/arm64. The latest tag points to this stable release.

What's Changed

• feat: build Fileament v1 by @TechHutTV in #1
• ci: publish versioned GHCR releases by @TechHutTV in #2
• ci: cross-compile release images natively by @TechHutTV in #3
• ci: support releases from private repository by @TechHutTV in #4

New Contributors

• @TechHutTV made their first contribution in #1

Full Changelog: https://github.com/TechHutTV/fileament/commits/v1.0.0