1 Uploading And Import
Forgejo Actions edited this page 2026-09-25 17:00:22 +00:00

Uploading and Import

You can add photos and videos from the browser, through the authenticated API, or from the command line. All three paths use the same Core-owned upload session model, so uploads behave consistently regardless of the client.

Originals are stored immutably and content-addressed with SHA-256. Exact-byte duplicates are stored once, without collapsing ownership: two owners who upload the same file still each own their media.

Uploads show status while they run, and failures surface per import class in the Processing issues area (the "Needs fixing" view in the Library), where they can be retried.

  • Browser uploads report progress and per-class import issues.
  • Failed items are visible and retryable rather than silently lost.
  • Where bytes live once stored is described in Storage Layout.

Details