garage/README.md

Garage [![Build Status](https://drone.deuxfleurs.fr/api/badges/Deuxfleurs/garage/status.svg?ref=refs/heads/main)](https://drone.deuxfleurs.fr/Deuxfleurs/garage)
===

<p align="center" style="text-align:center;">
	<a href="https://garagehq.deuxfleurs.fr">
	<img alt="Garage logo" src="https://garagehq.deuxfleurs.fr/img/logo.svg" height="200" />
	</a>
</p>

<p align="center" style="text-align:center;">
	[ <strong><a href="https://garagehq.deuxfleurs.fr/">Website and documentation</a></strong>
	| <a href="https://garagehq.deuxfleurs.fr/_releases.html">Binary releases</a>
	| <a href="https://git.deuxfleurs.fr/Deuxfleurs/garage">Git repository</a>
	| <a href="https://matrix.to/#/%23garage:deuxfleurs.fr">Matrix channel</a>
	]
</p>

Garage is an S3-compatible distributed object storage service
designed for self-hosting at a small-to-medium scale.

Garage is designed for storage clusters composed of nodes running
at different physical locations,
in order to easily provide a storage service that replicates data at these different
locations and stays available even when some servers are unreachable.
Garage also focuses on being lightweight, easy to operate, and highly resilient to
machine failures.

Garage is built by [Deuxfleurs](https://deuxfleurs.fr),
an experimental small-scale self hosted service provider,
which has been using it in production since its first release in 2020.

Learn more on our dedicated documentation pages:

- [Goals and use cases](https://garagehq.deuxfleurs.fr/documentation/design/goals/)
- [Features](https://garagehq.deuxfleurs.fr/documentation/reference-manual/features/)
- [Quick start](https://garagehq.deuxfleurs.fr/documentation/quick-start/)

Garage is entirely free software released under the terms of the AGPLv3.
Drone CI badge on branch main 2021-04-05 09:45:20 +00:00			`Garage [![Build Status](https://drone.deuxfleurs.fr/api/badges/Deuxfleurs/garage/status.svg?ref=refs/heads/main)](https://drone.deuxfleurs.fr/Deuxfleurs/garage)`
Add logo in repo 2021-03-17 09:26:50 +00:00			`===`
First commit: skeleton for something great 2020-04-05 21:33:42 +00:00
Add logo in repo 2021-03-17 09:26:50 +00:00			`<p align="center" style="text-align:center;">`
Center logo in book, add book CI 2021-03-19 13:25:57 +00:00			`<a href="https://garagehq.deuxfleurs.fr">`
Improve how node roles are assigned in Garage - change the terminology: the network configuration becomes the role table, the configuration of a nodes becomes a node's role - the modification of the role table takes place in two steps: first, changes are staged in a CRDT data structure. Then, once the user is happy with the changes, they can commit them all at once (or revert them). - update documentation - fix tests - implement smarter partition assignation algorithm This patch breaks the format of the network configuration: when migrating, the cluster will be in a state where no roles are assigned. All roles must be re-assigned and commited at once. This migration should not pose an issue. 2021-11-09 11:24:04 +00:00			`<img alt="Garage logo" src="https://garagehq.deuxfleurs.fr/img/logo.svg" height="200" />`
Add logo in repo 2021-03-17 09:26:50 +00:00			`</a>`
			`</p>`
Add drone badge 2021-02-08 14:04:22 +00:00
Improve how node roles are assigned in Garage - change the terminology: the network configuration becomes the role table, the configuration of a nodes becomes a node's role - the modification of the role table takes place in two steps: first, changes are staged in a CRDT data structure. Then, once the user is happy with the changes, they can commit them all at once (or revert them). - update documentation - fix tests - implement smarter partition assignation algorithm This patch breaks the format of the network configuration: when migrating, the cluster will be in a state where no roles are assigned. All roles must be re-assigned and commited at once. This migration should not pose an issue. 2021-11-09 11:24:04 +00:00			`<p align="center" style="text-align:center;">`
			`[ <strong><a href="https://garagehq.deuxfleurs.fr/">Website and documentation</a></strong>`
			`\| <a href="https://garagehq.deuxfleurs.fr/_releases.html">Binary releases</a>`
			`\| <a href="https://git.deuxfleurs.fr/Deuxfleurs/garage">Git repository</a>`
			`\| <a href="https://matrix.to/#/%23garage:deuxfleurs.fr">Matrix channel</a>`
			`]`
			`</p>`

Update README 2022-09-21 10:40:55 +00:00			`Garage is an S3-compatible distributed object storage service`
			`designed for self-hosting at a small-to-medium scale.`
First commit: skeleton for something great 2020-04-05 21:33:42 +00:00
Update README 2022-09-21 10:40:55 +00:00			`Garage is designed for storage clusters composed of nodes running`
			`at different physical locations,`
			`in order to easily provide a storage service that replicates data at these different`
			`locations and stays available even when some servers are unreachable.`
			`Garage also focuses on being lightweight, easy to operate, and highly resilient to`
			`machine failures.`
Pretty logging 2020-04-21 12:54:55 +00:00
Update README 2022-09-21 10:40:55 +00:00			`Garage is built by [Deuxfleurs](https://deuxfleurs.fr),`
			`an experimental small-scale self hosted service provider,`
			`which has been using it in production since its first release in 2020.`
Write some README 2020-06-30 12:59:55 +00:00
Update README 2022-09-21 10:40:55 +00:00			`Learn more on our dedicated documentation pages:`
Write some README 2020-06-30 12:59:55 +00:00
Update README 2022-09-21 10:40:55 +00:00			`- [Goals and use cases](https://garagehq.deuxfleurs.fr/documentation/design/goals/)`
			`- [Features](https://garagehq.deuxfleurs.fr/documentation/reference-manual/features/)`
			`- [Quick start](https://garagehq.deuxfleurs.fr/documentation/quick-start/)`

			`Garage is entirely free software released under the terms of the AGPLv3.`