How to configure Impossible Cloud Storage as a datastore in Proxmox Backup Server (PBS)
This article is a step-by-step guide to integrate Impossible Cloud as a S3 compatible datastore in Proxmox Backup Server (PBS).
Prerequisites
- Proxmox Backup Server (PBS) Version 4.0 or higher.
- Proxmox Virtual Environment (PVE) Version 8.0 or higher.
- An active Impossible Cloud Storage account.
Step 1: Create a bucket in the Impossible Cloud Storage Console
To create a bucket in the Impossible Cloud Storage Console, simply navigate to the buckets section and click Add Bucket.
Note: The S3 connector in PBS 4.0 is currently in tech preview. At this stage, it does not support buckets with versioning or object lock enabled. When creating a bucket for PBS 4.0, make sure to disable versioning and object lock. Please refer to the PBS release notes for updates on when support for these features becomes available.
Step 2: Create an access and secret key in the Impossible Cloud Storage Console
Access and secret keys are generated under the keys tab in the Impossible Cloud Storage Console. Remember to always securely store your access and secret key. Please find here detailed instructions on how to create an access and secret key.
Step 3: Add the S3 endpoint in your Proxmox Backup Server (PBS)
- Log into your PBS.
- Navigate to S3 Endpoints and press Add.
- Fill in the following information according to the configuration wizard:
- Specify a S3 endpoint ID (custom name) for the endpoint, e.g. 'ic-endpoint'.
- Configure the endpoint like this: ..storage.impossibleapi.net
You can use this endpoint for all buckets and regions, as Proxmox will dynamically read this information from the other configuration fields. - Keep the port as default (443).
- Leave path style disabled.
- Specify the Impossible Cloud region that you want to use, e.g. eu-central-2. Please find a list of all available regions here.
- Fill in the access and secret key that you have previously created in Step 2.
- Leave the fingerprint empty as Impossible Cloud is not using self-signed certificates.
- Enable Advanced settings and select Skip If-None-Match header under Provider Quirks.
- Press OK and finish the endpoint setup.
Step 4: Add a new S3 datastore in your PBS
You can now add a new Impossible Cloud datastore, following these steps:- Navigate to Datastore and press Add Datastore.
- Specify a Name for the new datastore and select S3 (tech preview) as type.
- Specify a local backing path as a local persistent cache.
- Select the S3 Endpoint ID of the IC endpoint that you configured in Step 3.
- Specify the garbage collection (GC) and prune schedule according to your requirements and press Add to complete the setup.
Note: You can find all details on adding datastores with a S3 backend in the official PBS documentation.
Step 5: Configure the new datastore as a storage in your Proxmox Virtual Environment (PVE) and create a new backup plan
As a last step, you need to add the created datastore in your PVE and create a new backup plan using the Impossible Cloud datastore:
- Log into your PVE.
- Navigate to Storage, press Add and select Proxmox Backup Server.
- Follow the storage configuration wizard to add your PBS instance and select the previously created IC datastore as the Datastore.
- Navigate to Backup and create a new backup plan using the Impossible Cloud Storage.
Note: Restores use the local cache whenever possible. In case the cache is missing (e.g., after deletion or on a new PBS server), run the Refresh contents from S3 bucket command on the datastore of your PBS to make the backups available for restore.