# S3 Buckets

Muppy utilise des Buckets S3 (ou compatible S3) chaque fois qu'il a besoin de stocker des données (par exemple lors des backups ou copies de bases de données).

{% hint style="success" %}
Muppy a été testé avec les systèmes de stockage S3 suivants:

* AWS S3
* Scaleway Object Storage (Compatible)
* OVH Public Cloud Storage (Compatible)
* Dell Elastic Cloud Storage (Compatible)
  {% endhint %}

## Créer un Bucket S3

Le menu Muppy / Configuration / S3 Buckets permet de configurer les Buckets S3.

Les informations nécessaires sont différentes selon que le Bucket est fourni par AWS ou qu'il est compatible.

### **Infos pour un bucket AWS S3**

* nom du bucket 
* région
* Access Key
* Secret Access Key

{% hint style="warning" %}
**Pro Tip**

Pour une meilleure sécurité, vous pouvez fournir 2 jeux de credentials. Le premier sera utilisé pour les backups, le second sera utilisé pour supprimer les fichiers.
{% endhint %}

### **Infos pour un bucket compatible S3**

Pour les buckets compatibles, il faut fournir en plus la **Endpoint URL**.

## Tester la connectivité au Bucket

L'onglet "Advanced" permet de configurer un "Debug Host" qui sera utilisé pour tester la connexion au Bucket en cliquant sur le bouton "Launch ls"

Le bouton "Launch ls" installe "aws cli" si nécessaire et lance une 'aws s3 ls'.

![](/files/3omMgQBb0tW6BQmBPJWI)

## Aide à la saisie des commandes AWS cli

Une fois le backup configuré, le champ "s3 Base Command" permet de copier dans le Presse Papier, une commande AWS CLI complète avec les credentials que vous pouvez utiliser comme base pour inspecter manuellement le bucket.

**Exemple de commande de base s3**

```bash
export AWS_DEFAULT_REGION="eu-west-3" && export AWS_DEFAULT_OUTPUT="json" && export AWS_ACCESS_KEY_ID="False" && export AWS_SECRET_ACCESS_KEY="False" ; aws False s3 --summarize --human-readable --recursive ls s3://False
```

## Ré-indexation d'un Bucket S3

Muppy est capable de ré-indexer les dumps de bases de données présents sur un Bucket S3. 

Ceci vous permets de récupérer les backups de database (pgdumps) sauvegardés par un autre serveur Muppy et de les restaurer.

Pour cela, cliquer sur le bouton "Index pgdumps" situé en haut du formulaire.

## Support des buckets avec un self-signed certificate

Si vous êtes sur un réseau privé et que le certificat de vos Buckets S3 ne peux pas être vérifié, cocher **"--no-verify-ssl".** Muppy ajoutera l'option correspondante à chaque invocation de AWS cli.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.muppy.io/guides/configuration/s3-buckets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.