# dedup4j

> Store identical bytes once — deduplicated blob storage for Spring Boot, backed by your own database and object store.

- Source code: https://github.com/heyEdem/dedup4j
- Full documentation in one file: https://dedup4j.churchillakomaning.online/llms-full.txt

## Getting started

- [Installation](https://dedup4j.churchillakomaning.online/docs/getting-started/installation.md): Add the dedup4j starter to a Spring Boot application.
- [Quick start](https://dedup4j.churchillakomaning.online/docs/getting-started/quick-start.md): Store, retrieve and release your first blob.

## Guides

- [Spring Boot integration](https://dedup4j.churchillakomaning.online/docs/guides/spring-boot.md): How dedup4j auto-configures inside a Spring Boot application.
- [Storage providers](https://dedup4j.churchillakomaning.online/docs/guides/providers.md): Configure the filesystem, S3 or Azure storage provider.
- [Uploading & deduplication](https://dedup4j.churchillakomaning.online/docs/guides/uploading.md): How uploads are hashed, deduplicated and batched.
- [Retrieval, retain & release](https://dedup4j.churchillakomaning.online/docs/guides/lifecycle.md): Read blobs back and manage their reference counts.
- [Observability & dashboards](https://dedup4j.churchillakomaning.online/docs/guides/observability.md): Metrics, actuator endpoints and dashboards for dedup4j.

## Reference

- [Configuration properties](https://dedup4j.churchillakomaning.online/docs/reference/configuration.md): Every dedup4j configuration property and its default.
- [Public API](https://dedup4j.churchillakomaning.online/docs/reference/api.md): The public types and methods of dedup4j.
- [Troubleshooting](https://dedup4j.churchillakomaning.online/docs/reference/troubleshooting.md): Exceptions, failure modes and how to diagnose them.

## Project

- [Architecture & limitations](https://dedup4j.churchillakomaning.online/docs/architecture.md): How dedup4j works, and what it deliberately does not do.
- [Contributing](https://dedup4j.churchillakomaning.online/docs/contributing.md): Build dedup4j from source and contribute changes.