Custom Storage

Updraft provides the ability to provide your own Google Cloud Storage bucket or your own S3 bucket (e.g. AWS or Exoscale) for storing your assets and app binaries.

Enterprise Plan organization can configure their own custom storage. All app versions and binaries as well associated files like app icons are uploaded and stored on your own custom storage.

The following options can be offered in the Enterprise Plan:

  • S3 compatible storage (AWS, Exoscale)

  • Google Cloud Storage

S3 comptaible storage (AWS, Exoscale)

For those considering S3 compatible storage, specifically through AWS or a similar S3-compatible storage provider, the following steps outline the process of integrating this custom storage option into your Updraft setup:

What you need

Before you start make sure you have

  • Access to S3 Compatible Storage: Get the credentials to connect to your chosen storage service.

  • Access with the Right Permissions: Associate the necessary permissions with your key to interact with the bucket.

Permissions Policy AWS Example

Below is a sample policy snippet for AWS that ensures the correct permissions are in place:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "s3:*", "Resource": "arn:aws:s3:::bucket-name" } ] }

This policy permits a range of actions on the specified storage bucket, including uploads, retrieval, and management of files.

Connect S3 Bucket with Updraft

  1. Log in to Updraft and go to "Profile -> Overview"

  2. In the next step choose the option "S3"

  3. Click on enable to add your custom storage.

ℹ️ If you choose another S3 compatible storage provider than AWS. You can leave the Region empty and enter your endpoint URL instead.

Google Cloud Storage

For those considering using Google Cloud Storage, the following steps outline the process of integrating this custom storage option into your Updraft setup.

What you need

  • Google Cloud storage bucket: You need to create a google cloud storage bucket.

  • Project ID: Google Project ID where your bucket is located.

  • Service Account Key: Service Account key to access the bucket. See create service account key.

Connect Google Cloud Storage With Updraft

  1. Log in to Updraft and go to "Profile -> Overview"

  2. In the next step choose the option "Google Cloud Storage"

  3. Click on enable to add your custom storage.

Deactivate Custom Storage

Custom storage provides flexibility for storing your uploaded data, but there may be occasions when you need to deactivate or reactivate it.

Steps

  1. Accessing Custom Storage Settings: Navigate to your account overview settings and find the "Custom Storage" section.

  2. Click on the "Deactivate Custom Storage" option.

  3. Confirm your action by entering your account password.

Uploading new app versions/builds:

  • Once custom storage is deactivated, new data will be stored on the Updraft DB system again.

  • Ensure that you're aware of this change when uploading new builds.

Old app versions/builds

  • Each previously uploaded build will not be available anymore

  • If a build is stored on inaccessible custom storage, a proper information message will be displayed when attempting to download it.

  • Custom storage settings are not removed from the database until the custom storage integration is deleted.

  • Reactivating Custom Storage: If you choose to reactivate custom storage, the URLs from previously uploaded builds on custom storage become valid again.

Conclusion: Managing custom storage settings ensures control over where your data is stored. Following these steps allows for a seamless transition between storage options, maintaining accessibility and clarity regarding your uploaded builds.

Note: Make sure to keep your account password secure and be mindful of the storage location information when interacting with builds.

Last updated