Skip to content
DockHiveDockHiveDockHive Docs

Quickstart: your first bucket

This takes about three minutes. You need a DockHive account and the AWS CLI installed.

1. Create a bucket

Section titled “1. Create a bucket”
  1. In the console, open Hive Buckets and click Create bucket.
  2. Enter a Bucket name, for example my-app-uploads. Names are unique across DockHive: 3-63 characters, lowercase letters, numbers, hyphens and dots.
  3. Pick a Region close to your users. See Endpoints and regions.
  4. Leave Visibility on Private (you can change it later) and click Create bucket.

2. Create an access key

Section titled “2. Create an access key”
  1. Open Hive Buckets → Access keys and click Create access key.
  2. Give it a Name (for example laptop), choose All buckets or Selected buckets, and pick a Permission: Read & write is right for most apps.
  3. Click Create key and copy the Access key ID (it starts with DH) and the Secret access key. The secret is shown only once.

3. Configure the AWS CLI

Section titled “3. Configure the AWS CLI”
Terminal window
aws configure --profile dockhive
# AWS Access Key ID:     DH...
# AWS Secret Access Key: <your secret>
# Default region name:   auto
# Default output format: json


aws configure set s3.addressing_style path --profile dockhive

4. Upload, list and download

Section titled “4. Upload, list and download”
Terminal window
export AWS_PROFILE=dockhive
EP=https://s3.dockhive.io


echo "hello from Hive Buckets" > hello.txt
aws s3 cp hello.txt s3://my-app-uploads/hello.txt --endpoint-url $EP
aws s3 ls s3://my-app-uploads/ --endpoint-url $EP
aws s3 cp s3://my-app-uploads/hello.txt - --endpoint-url $EP

Your file also shows up in the bucket’s file browser in the console.

Next steps

Section titled “Next steps”