To use an Amazon S3 Storage board, you need an Amazon S3 bucket and a user with enough permissions to access the S3 bucket. You can sign-up and create those at Note that it can take a few minutes after you've created it before a bucket is usable.

  bucket = Sys.getenv("AWS_BUCKET"),
  key = Sys.getenv("AWS_ACCESS_KEY_ID"),
  secret = Sys.getenv("AWS_SECRET_ACCESS_KEY"),
  cache = NULL,
  region = NULL,
  host = "",
  name = "s3",



The name of the Amazon S3 bucket.

key, secret

The key and secret for your space. You can create a key and secret in the "Spaces access keys" in your API settings.

The secret is equivalent to a password, so generally should not be stored in your script. The easiest alternative is to store it in the AWS_SECRET_ACCESS_KEY environment variable, which board_s3() will use by default.


Cache path. Every board requires a local cache to avoid downloading files multiple times. The default stores in a standard cache location for your operating system, but you can override if needed.


The region to use, required in some AWS regions and to enable V4 signatures.


The host to use for storage, defaults to "".


An optional name used identify the board. This is no longer generally needed since you should be passing around an explicit board object.


Additional parameters required to initialize a particular board.

See also


if (FALSE) { # the following example requires an Amazon S3 API key board <- board_s3(bucket = "s3bucket") }