Blixt Documentation v2.11

Create a bucket

  1. Sign in to the AWS S3 Console.
  2. Click Create bucket.
  3. Choose a region and give the bucket a name.
  4. Leave the default settings and click Create bucket.

Credentials and permissions

The credentials need s3:* permissions on your bucket: in the IAM Console, create a user, or a role, that has them. BlixtFS then finds the credentials where the AWS CLI does, or takes a key pair.

A profile. If aws configure or aws configure sso has set up a profile on the machine, BlixtFS uses the default profile, or the one named by --aws_profile (cloud.aws.profile). Profiles that sign in with single sign-on expire: when BlixtFS reports that AWS did not accept the credentials, run aws sso login --profile NAME again. BlixtFS reads ~/.aws/config and ~/.aws/credentials; to read other files, set both --aws_config_file and --aws_credentials.

An access key. On the user’s Security credentials tab, click Create access key, and copy the Access key ID and Secret access key. Set them with --aws_access_key and --aws_secret_key (cloud.aws.access_key, cloud.aws.secret_key), with --aws_session_token (cloud.aws.session_token) for temporary keys. A key pair takes precedence over any profile. The config server never sends keys to other servers, so in a scale-out deployment give each server its own.

In the MacOS app, the setup assistant lists the profiles it finds, or takes the keys, and tests them before saving them.

Project

The AWS account the buckets are recorded under. Set it with AWS_PROJECT, --aws_project or cloud.aws.project.