Storage Providers

Introduction

This page describes the backend storage providers supported by the armory.

Local Storage Provider (local)

The local storage provider is the default backend storage provider for the armory. You can use any locally mounted filesystem as the backend for the armory. The path you provide must be writable.

S3 Storage Provider (s3)

The S3 storage provider allows you to use a general purpose S3 bucket as the storage backend for the armory. Directory buckets are not supported. For credentials, the armory operates the same as the AWS CLI and can use the default profile or IAM. The credentials must provide the following permissions to the bucket:

• s3:CreateBucket: Only needed if the specified bucket has not been created.
• s3:ListBucket: For listing the objects in the bucket. This is necessary to generate the index and enable auto refreshing of the index.
• s3:GetObject: For reading objects from the bucket. This is required to serve objects from the bucket and read the configuration.
• s3:PutObject: For adding objects to the bucket. This is required to use package administration functions, refresh the index, and to write the configuration.
• s3:DeleteObject: For removing objects from the bucket. This is required for package administration functions.