Quick Guide - Linux OS

Modified on Wed, 25 Jan 2023 at 05:18 PM


Creating a bucket 

See > how to create a bucket.

Creating a security key 

To create a key: open the BigStorage website > click on the hamburger icon to open the pages > select the keys page > add a key name, select the permission level and select 'Add key' 

For more information on naming conventions see: Bucket tag name and naming conventions.

The new key will be displayed on the keys page. The secret and access key can be found by selecting the icon under 'Reveal Keys'. Copy, and use this when you use your S3-Compatible client software to access the bucket.

Please note: You need to associate the security key to your buckets, for more information see > how do I grant access to the files in my bucket?

Installing S3 to access your bucket

  1. ACCESS BUCKET - Install s3cmd with: 
    sudo apt-get update && sudo apt-get install s3cmd
    s3cmd --configure (setup access to s3)
    • Access Key: ********
    • Secret Key: ***********
    • Default Region: Africa
    • S3 Endpoint: s3.bigstorage.io
    • DNS-style bucket+hostname:port template for accessing a bucket: %(bucket)s.s3.bigstorage.io
    • Encryption password: *********
    • Path to GPG program: /usr/bin/gpg
    • Use HTTPS protocol: True
    • HTTP Proxy server name:
    • HTTP Proxy server port: 0

You may also want to take at look at this site to check out other Linux packages: https://s3tools.org/repositories

Mounting a bucket

Install dependencies

apt-get install build-essential libfuse-dev libcurl4-openssl-dev libxml2-dev mime-support automake libtool

Install s3fs (s3fs allows Linux, macOS, and FreeBSD to mount an S3 bucket via FUSE)

sudo apt install s3fs

Mount bucket

chmod 600 ${HOME}/.passwd-s3fs
s3fs mybucket /path/to/mountpoint -o passwd_file=${HOME}/.passwd-s3fs

Mount command:

s3fs <bucket-name> /mount/point -o use_path_request_style -o passwd_file=${HOME}/.passwd-s3fs,uid=`id -u`,umask=0077,mp_umask=0077 -o url=http://s3.bigstorage.io

Unmount command

fusermount -u /mount/point

Copy to bucket 

s3cmd put Pictures s3://bucket-name --recursive

Viewing the bucket

s3cmd ls s3://bucket-name
s3cmd ls s3://bucket-name/Pictures/

Downloading a file from a bucket

s3cmd get s3://bucket-name/<FILE_NAME> LOCAL_FILE

Deleting a file from a bucket

s3cmd del s3://bucket-name/<FILE_NAME>

Noticed a discrepancy or a bug? > Let Us Know!

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article