S3FS Setup and Usage
Last updated
Last updated
S3FS allows you to mount an S3-compatible server as a file system on your local machine using the FUSE-based S3FS utility.
This section provides step-by-step instructions for setting up and using S3FS with your ZS3Server.
Create a .passwd-s3fs
file containing your ACCESS_KEY_ID
and SECRET_ACCESS_KEY
:
Example:
Update the file permissions for security:
Create a directory to use as the mount point:
The MinIO Client allows you to interact with your MinIO server.
The MinIO Server provides an S3-compatible API and supports core S3 features. Choose one of the following installation methods for Linux:
RPM (RHEL-based Systems)
Download the latest stable MinIO RPM package. Install the package using dnf
:
DEB (Debian/Ubuntu Systems)
Download the appropriate .deb
package from the MinIO Downloads Page. Install the package using dpkg
:
Binary Installation (Universal Method)
Download the MinIO Server binary. Make the binary executable and move the binary to a directory in your system PATH:
The MinIO Client allows command-line interaction with your MinIO server.
Download the MinIO Client binary:
Make the binary executable:
Move the binary to a directory in your system PATH:
Verify the installation:
Set an alias for your server:
Replace <BLIMP_DOMAIN>
with the domain link from the Blimp output.
Replace <ACCESS_KEY>
and <SECRET_KEY>
with your credentials.
Example:
Verify the alias setup by listing buckets:
Use MinIO Client to create a bucket:
List the contents of the S3 server to verify:
The bucket s3fs
should now be visible.
Mount the S3 bucket as a local file system:
Replace the placeholders:
mybucket
with the name of your bucket (s3fs
).
/path/to/mountpoint
with /mnt/s3fs
.
Example using Blimp URL:
Check the mounted file system:
Navigate to the mount point:
Create a file in the mounted directory:
List the contents to verify the file:
Open the Blimp dashboard. Navigate to the bucket associated with the mounted directory (s3fs
).
Confirm that the file (file1.txt
) and other contents of the mounted directory are visible on Blimp.
The S3FS utility uses FUSE (Filesystem in Userspace) to mount S3 servers as a local file system.
The s3fs
command includes options for security and compatibility:
-o passwd_file=${HOME}/.passwd-s3fs
: Specifies the password file.
-o url=https://url.to.s3/
: Points to the S3-compatible server URL.
-o use_path_request_style,allow_other,umask=000,complement_stat
: Enables compatibility and allows other users to access the mounted file system.
Compression: If you are using compression, it's recommended to use the MinIO Client for efficient file operations.