Skip to main content
Flux is a secure, encrypted file platform built for privacy-first storage and delivery. These docs cover the internal services, API endpoints, and architecture that power Flux.
These docs are intended for internal developers only. All services run on the internal network and are not accessible from the public internet. If you’re looking for the user-facing product, visit fluxdrop.eu.

​
Platform services

Flux is composed of modular services, each responsible for a specific domain:

Metadata Service

Manages file metadata, DEK wrapping, caching with Valkey, and aggregate statistics.

Thumbnail Service

Generates and serves responsive thumbnails for uploaded files.

Webhooks

Sends notifications about events in the Flux ecosystem.

Flux Pass

Handles authentication, sessions, and access control.

​
Key concepts

Before diving into the API, familiarize yourself with these core concepts:

​
FAQ

Yes! Every file uploaded to Flux is fully encrypted, with the sole exception of file thumbnails. We use a combination of Master Keys and per-file Data Encryption Keys (DEKs).
Currently, our API is restricted to internal use only. We are focused on building a rock-solid foundation for our own web applications before opening up to third-party developers.
We utilize highly reliable S3-compatible object storage across multiple regions, paired with our fast Valkey caching layer to ensure minimal latency.

​
API conventions

All Flux API endpoints follow a consistent pattern:
  • Current version: v1
  • No hyphens in endpoint paths
  • Standard methods: POST, GET, DELETE
Read the full API conventions guide for details.

​
Get started

Quickstart

Set up your environment and make your first API call in minutes.