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

Your first five minutes ​

Flare gives you a home for screenshots, recordings, files, text, and links on a server you control. Upload something, get a link, and decide who can open it. Your library keeps everything together, with folders, tags, search, and previews when you need them.

This guide is for people using an existing Flare instance. Everyone supplies the starting permissions; additional roles can add capabilities, and administrators can restrict the baseline. A missing navigation item or unavailable action may reflect your current permissions. If you're installing your own, start with the administrator guide.

Scroll through every file and use the date rail to jump through your upload history.
Flare file library with image previews, search, folders, and file controls

Scroll through every file and use the date rail to jump through your upload history.

Join your instance ​

Open the address your administrator gave you and sign in. Depending on the instance, you may see a registration option, a sign-in button for an identity provider, or only a local email and password form.

  • Registration available: create an account, then follow any email-verification instructions.
  • Registration closed: ask the administrator for access. A public file link does not require an account unless the file's access settings require one.
  • Two-factor authentication: after your password, enter your authenticator code or a saved recovery code if you enabled this protection. Set it up.
  • Passkeys: choose Sign in with a passkey to use a passkey already registered to your account. Add a passkey.
  • Passkey required: password and SSO sign-in are blocked after you explicitly enable this setting. Use your passkey, or Use a passkey recovery code with your email and one dedicated emergency code. Understand the requirement.
  • Single sign-on: use the provider offered by your instance. Existing local accounts are not automatically linked to SSO accounts with the same email address.

The name, colors, logo, and background can differ between instances. The tasks and controls described here stay the same.

Use an allowed account method. Requiring passkeys disables password and SSO sign-in; dedicated passkey recovery codes remain an emergency option.
Flare login with email and password fields and a separate Sign in with a passkey button

Use an allowed account method. Requiring passkeys disables password and SSO sign-in; dedicated passkey recovery codes remain an emergency option.

Upload and share your first file ​

  1. Open Upload in the navigation.
  2. Drop a file into the selection area, or click it to browse your device.
  3. Choose Public (anyone with the link) to share it with another person. Choose Private (only me) to keep it in your account; accounts with content.read also retain access.
  4. Optionally add a password or expiration.
  5. Start the upload and wait for the completion result.
  6. Choose Copy link, then send that link to your recipient.

The copied link opens a Flare share page. A password or private setting still applies after copying. For a useful access check, open a public link in a signed-out browser window: your own signed-in session can access files that other people cannot.

Continue with uploading files and sharing and privacy.

Find your way around ​

PlaceWhat you can do
FilesSearch, preview, download, organize, and manage access to uploaded files and pastes.
UploadQueue files and choose the destination, upload profile, visibility, password, and expiration.
PasteSave text or code as a shareable file.
LinksCreate short redirects under your instance's domain and see their click counts.
Profile → AccountUpdate identity, password, email, appearance, login history, and active sessions.
Profile → UploadsConfigure screenshot tools, reusable upload profiles, and account upload defaults.
Profile → IntegrationsCreate scoped API tokens and outgoing webhooks.
Profile → Your dataCheck storage use, export data, or delete your account.
Audit logInvestigate instance activity with the audit.read permission.
Users / SettingsAdministrator controls for accounts and the instance.

On a small screen, use the navigation menu to reach these pages. Profile and Settings remember the selected section in the page address, so browser Back and Forward work when moving between sections.

Build a workflow that fits ​

I share screenshots throughout the day

Create a Public screenshots upload profile, review its defaults, and download a capture-tool configuration from that profile. A capture can upload and copy its share link without opening the dashboard. Add a filename tag rule to collect related captures automatically.

I need a private working library

Create a private upload profile and make it your default. Use folders for projects and tags for topics that cross project boundaries. Private files are accessible to you (with files.read) and accounts with content.read. Making a folder public does not expose its private files.

I send temporary reviews or recordings

Use a profile with public visibility, a relative expiration, and Make private as its expiry action. The public link stops being accessible after the scheduled action runs, while the file remains in your library. Choose Delete file instead if you also want Flare to remove the stored copy.

I want to automate uploads

Start with a generated Bash script. For a custom application, use a named API token with only the permissions it needs. Webhooks notify a receiver when a file is ready.

A few things to know early ​

An instance is its own service. Accounts, limits, storage, registration, email, and branding belong to that installation. Ask its administrator about availability and backups.

Public means accessible by link. Treat the link as something recipients can forward. A folder share can also list public files placed directly in that folder.

Private and password-protected are different. A password on a public file lets another person unlock it. A password on a private file does not give other people access.

Defaults affect future uploads. Changing a profile, default expiration, or URL-naming choice does not rewrite files already uploaded.

Deletion is permanent in Flare. Download or export anything you need before deleting a file or account. There is no user-facing trash or undo flow.

Where to go next ​