72 lines
2.7 KiB
Markdown
72 lines
2.7 KiB
Markdown
# garage
|
|
|
|
> An open-source distributed object storage service tailored for selfhosting at a small-to-medium scale.
|
|
|
|
<!-- metadata -->
|
|
|
|
* **Category**: Apps
|
|
* **Status**: wip
|
|
* **Image**: [`garage`](https://hub.docker.com/r/dxflrs/garage), 4, upstream
|
|
* **Healthcheck**: No
|
|
* **Backups**: No
|
|
* **Email**: N/A
|
|
* **Tests**: No
|
|
* **SSO**: N/A
|
|
|
|
<!-- endmetadata -->
|
|
|
|
## Quick start
|
|
|
|
- `abra app new garage`
|
|
- If you are **creating a new cluster**:
|
|
- Generate a new rpc_secret: `abra app secret generate --all`
|
|
- Note: all nodes must share the same rpc secret, do not lose this value if you plan to cluster garage!
|
|
- Note: In older versions of abra you must generate the secret locally with `openssl rand -hex 32` then insert the result as described below
|
|
- `abra app config <app-domain>`
|
|
- If this Garage node is **joining an existing cluster**:
|
|
- Insert the existing rpc_secret: `abra app secret insert <app-domain> rpc_secret v1 <rpc-secret>`
|
|
- `abra app config <app-domain>`
|
|
- Uncomment the block that starts with `## Bootstrap this node`
|
|
- Set `BOOTSTRAP_HOST` and `BOOTSTRAP_ID`
|
|
- `abra app deploy <app-domain>`
|
|
|
|
## Configuration
|
|
|
|
### Allow RPC Connections
|
|
|
|
* Your ingress controller must be set up to allow connections on port 3901. We assume you're using Traefik
|
|
* `abra app configure <traefik-app-name>`
|
|
* Uncomment the block that starts with `## Garage`
|
|
* Re-deploy Traefik: `abra app undeploy -n <traefik-app-name> && sleep 5 && abra app deploy -n <traefik-app-name>`
|
|
|
|
### Prepare the Garage Client
|
|
To interact with garage inside docker, it's best to create an alias for the following abra run command.
|
|
```
|
|
alias garage="abra app run <app domain> -- app /garage"
|
|
```
|
|
Run `garage status` to verify everything is working.
|
|
|
|
You can optionally add this alias to your `.bashrc` (or similar) file to avoid having to define it repeatedly.
|
|
|
|
|
|
### Garage Quick Start Guide
|
|
Once `garage status` works, you can follow the guide here: https://garagehq.deuxfleurs.fr/documentation/quick-start/#checking-that-garage-runs-correctly
|
|
|
|
|
|
|
|
## Backups
|
|
|
|
> In development, not currently reliable
|
|
|
|
By default, backups will only capture a snapshot of the metadata directory, which includes bucket names, hashed secrets, and other related information.
|
|
By default, the actual data will not be backed up!
|
|
If you're running Garage in a cluster, when you restore the metadata, other nodes will provide any missing data.
|
|
|
|
### To enable full data backups
|
|
* `abra app config <app domain>`
|
|
* Uncomment the block that starts with `## Enable Full Data Backups`
|
|
* Re-deploy Garage: `abra app undeploy -n <app domain> && sleep 5 && abra app deploy -n <app domain>`
|
|
|
|
|
|
For more, see [`garagehq.deuxfleurs.fr`](https://garagehq.deuxfleurs.fr/documentation/cookbook/real-world/).
|