Skip to content
Docs for Flare rolling (v2.1.0) Updated c9105238Build details ↗Versions & changes
Rolling preview · Unreleased

These docs describe a rolling build, not a stable release.

Read stable docs
View docs

A home for your files. Built around you. ​

Flare brings uploads, previews, organization, and automation to your own server and domain. Start with the essentials; add the tools and settings that fit your workflow.

Filter the capabilities below, or take a guided tour. Each card leads to a complete guide with instructions and important limits.

You can also open the handbook from Documentation in the Settings header, or choose Setup guide during first-run setup. Both open a new tab so your current form stays in place, selecting your stable release's archive or the published rolling handbook. Setup links for versions before 2.1.0 open the archive homepage with the original setup guidance. Other prerelease or unknown versions open the version selector.

Reading for a particular installation? Browse dated documentation releases and compare changes. The public handbook defaults to the current stable release. The versions page also offers explicit access to the published rolling build's unreleased docs.

31 of 31 capabilities

Share

File uploads

Drag and drop, queue multiple files, choose a destination, and transfer large files in chunks.

Share

Rich previews

Images with zoom, video, audio, PDFs, CSV tables, plain text, and syntax-highlighted code.

Share

Sharing controls

Public or private access, password protection, expiring links, and view/download counts.

Share

Pastes & code

Turn a note or code snippet into a hosted text file with a read-only preview.

Share

Short links

Create a compact URL on your domain and follow its click count.

Share

Screenshot tools

Download account-ready configurations for ShareX and iTake, or scripts for Flameshot, Spectacle, and Bash.

Organize

Folders & subfolders

Give files a home, move them in bulk, and share direct public contents in a folder gallery.

Organize

Tags & automatic rules

Edit current tags across a retained selection, filter by a tag, and apply matching rules by filename or extracted image text.

Organize

Search & filters

Find files by name or OCR text, and narrow the library by date, type, tags, and visibility.

Organize

Continuous file timeline

Scroll through every matching file and use a quiet date rail to jump into your upload history.

Organize

Image gallery

Browse images by month, open the lightbox, and navigate with keyboard arrows or touch.

Organize

Archives

Browse shared archive entries, or extract and create ZIP/TAR.GZ files in your own library with private defaults or an explicit profile.

Organize

OCR

Extract text from images in the background for searching and automatic tagging.

Personalize

Upload profiles

Reuse visibility, expiration, URL naming, tags, and share-page preferences across clients.

Personalize

Appearance studio

Preview and publish your identity, light/dark palettes, typography, and shared-page layout.

Personalize

Portable recipes & packs

Export upload preferences and appearance designs. Recipe tags remain specific to their original account.

Personalize

Your account

Manage avatar, password, personal theme, upload token, default expiration, and data export.

Personalize

Two-factor authentication

Protect password sign-in with authenticator codes (2FA) and keep one-time recovery codes for a lost device.

Personalize

Passkeys

Sign in with your device or security key; optionally require a passkey and save separate emergency recovery codes.

Personalize

Login history & active sessions

Review recent sign-ins and their device details, then revoke one browser session or every session on your account.

Host & administer

Instance audit log

Investigate file activity, background processing, access failures, role changes, and settings with searchable audit events.

Automate

Scoped API tokens

Give each integration its own revocable permissions, expiration, and optional upload profile binding.

Automate

Upload & listing API

Use multipart or chunked uploads, list files, and create or manage short links.

Automate

Signed webhooks

React to file.ready events with HMAC signatures, retries, test events, and delivery history.

Host & administer

Guided setup

Create an administrator, choose storage and registration policy, then optionally personalize and configure email.

Host & administer

Local or S3 storage

Use persistent disk or an S3-compatible bucket, with a PostgreSQL database for metadata.

Host & administer

Roles & permissions

Combine permission groups, delegate moderation or design, and protect administrator access with role hierarchy.

Host & administer

Access & moderation

Manage users, roles, shared storage quotas, registration, and uploaded content.

Host & administer

Account email

Optional SMTP delivery, password recovery, address verification, and confirmed email changes.

Host & administer

OpenID Connect

Connect an identity provider, control provisioning, and retain a local administrator recovery route.

Host & administer

Operate with confidence

Back up the database and files, preserve secrets, upgrade carefully, and diagnose failures.

Choose your starting point ​

You want to…Start here
Set up a personal file hostDocker Compose → first-run setup
Run a shared instanceRoles and permissions → users → email → backups
Send screenshots straight to your domainScreenshot tools → upload profiles
Share a collectionFolders → sharing and privacy
Find an older upload in a large libraryContinuous scrolling and the date rail → recorded walkthrough
Browse shared archives, extract, or package filesArchives
Protect your sign-inTwo-factor authentication and passkeys
Require a passkey instead of password or SSOPasskey requirement and emergency recovery
Review sign-ins or sign out a lost deviceLogin history and active sessions
Investigate activity or a failed operationInstance audit log
Match your own brandAppearance studio
Connect your own softwareAPI → signed webhooks

Know what you are choosing ​

Flare needs a running application server and PostgreSQL. Local storage also needs a persistent writable filesystem; S3 is an alternative file store. The documentation can run on a static host, but Flare itself cannot. Read the deployment guide before choosing infrastructure.

Private files are restricted to their owner and accounts with permission to read other users’ content. This is a self-hosted sharing application, not an end-to-end encrypted vault. See sharing and privacy for the exact rules, including passwords, folder links, and storage URLs.

These docs describe the source revision shown on the page. If a control is missing on an older installation, check the version in Settings → General, open its documentation archive, review the release notes, and follow the upgrade guide.