S3FS(1) User Commands S3FS(1) (NAME) s3fs - FUSE Amazon S3 (SYNOPSIS) (mounting) s3fs bucket[:/path] mountpoint [options] s3fs mountpoint [options (must specify bucket= option)] (unmounting) umount mountpoint (root). fusermount -u mountpoint . ( ) (utility mode) s3fs --incomplete-mpu-list (-u) bucket s3fs --incomplete-mpu-abort[=all | =] bucket (DESCRIPTION) s3fs FUSE Amazon S3 (mount) . S3 ( ). (AUTHENTICATION) s3fs AWS (https://docs.aws.amazon.com/cli/latest/userguide/cli-config- files.html) ${HOME}/.aws/credentials . s3fs passwd . AWS (session token) AWS . s3fs ( ): accessKeyId:secretAccessKey : bucketName:accessKeyId:secretAccessKey : /etc/passwd-s3fs [0640] $HOME/.passwd-s3fs [0600] s3fs AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY . (OPTIONS) (general options) -h --help . --version . -f FUSE - (daemon). -s FUSE ( ). (mount options) s3fs "opt" : = -o bucket ( ) -o . -o default_acl (="private") (canned acl) s3 "private" "public-read". canned ACL https://docs.aws.amazon.com/AmazonS3/latest/dev/acl- overview.html#canned-acl . -o retries (="5") S3. -o tmpdir (="/tmp") . -o use_cache (="" ) . -o check_cache_dir_exist ( ) use_cache . . -o del_cache - s3fs. -o storage_class (="standard") . : standard standard_ia onezone_ia reduced_redundancy intelligent_tiering glacier glacier_ir deep_archive. -o use_rrs ( ) Reduced Redundancy Storage . use_sse . ( use_rrs=1 ) storage_class . -o use_sse ( ) : SSE-S3 SSE-C SSE-KMS. SSE-S3 Amazon S3 SSE-C SSE-KMS AWS KMS . "use_sse" "use_sse=1" SSE-S3 (use_sse=1 ). SSE-C "use_sse=custom" "use_sse=custom:" "use_sse=" ( ). "c" "custom" . 600 . SSE-C . . . SSE-C SSE- C . "custom" ("c") load_sse_c AWSSSECKEYS . ( AWSSSECKEYS SSE-C ":" ). SSE . load_sse_c . SSE-KMS "use_sse=kmsid" "use_sse=kmsid:" . "k" "kmsid" . SSE-KMS AWS KMS "kmsid:" ( "k:") . "kmsid" ("k") AWSSSEKMSID . KMS EC2 . SSE-KMS (endpoints) (SSL) (TLS) . -o load_sse_c - SSE-C . "use_sse=custom" . . SSE-C SSE-C . AWSSSECKEYS . -o passwd_file (="") $HOME/.passwd-s3fs /etc/passwd-s3fs . -o ahbe_conf (="" ) HTTP () . : ----------- line = [file suffix or regex] HTTP-header [HTTP-values] file suffix = file (object) suffix, if this field is empty, it means "reg:(.*)".(=all object). regex = regular expression to match the file (object) path. this type starts with "reg:" prefix. HTTP-header = additional HTTP header name HTTP-values = additional HTTP header value ----------- : ----------- .gz Content-Encoding gzip .Z Content-Encoding compress reg:^/MYDIR/(.*)[.]t2$ Content-Encoding text2 ----------- "test" . HTTP "Content- Encoding" RFC 2616 . -o profile (="default") (profile) ${HOME}/.aws/credentials S3. AWS CLI passwd s3fs . -o public_bucket (="" ) 1 $HOME/.passwd-s3fs /etc/passwd-s3fs . S3 API (copy object) public_bucket=1 s3fs nocopyapi . -o connect_timeout (="300" ) . -o readwrite_timeout (="120" ) / . -o list_object_max_keys (="1000") S3 list object API. . . -o max_stat_cache_size (="100,000" ( 40 )) stat . -o stat_cache_expire ( 900 ) () stat . . -o stat_cache_interval_expire ( 900 ) () stat . . stat_cache_expire . -o enable_negative_cache ( ) stat . HeadObject . . -o disable_negative_cache ( ) s3fs stat . . . HeadObject ..TP -o no_check_certificate ( ) (CA) . -o ssl_verify_hostname (="2") 0 SSL (hostname) . -o ssl_client_cert (="") SSL . : "[:[:[: [:]]]]" : . NickName ( NSS ) . : "PEM" (). : (). : "PEM" (). : (). "S3FS_SSL_PRIVKEY_PASSWORD" . -o nodnscache - DNS. s3fs DNS DNS . -o nosscache - SSL. s3fs SSL SSL . -o multipart_size (="10") (part) (multipart). . -o multipart_copy_size (="512") mixupload. . . -o max_dirty_data (="5120") (dirty data) S3 . . -1 . nomixupload . -o bucket_size (= long) (bucket) statvfs . (GB GiB TB TiB PB PiB EB EiB) ( ). : 20000000 30GB 45TiB. s3fs ( ): s3fs . -o ensure_diskfree ( 0) . s3fs . s3fs . s3fs . -o free_space_ratio (="10") . 0 100 . . 50GB 50GB * 10%% = 5GB . -o multipart_threshold (="25") . . -o singlepart_copy_limit (="512") . -o host (="https://s3.amazonaws.com") https://example.com. -o servicepath (="/") . -o url (="https://s3.amazonaws.com") url Amazon S3 . HTTP "url=http://s3.amazonaws.com" . https URL url . -o region (="us-east-1") (region) (signature version 4) . s3fs "us-east-1" . s3fs . s3fs . s3fs s3fs S3 . -o endpoint . -o sigv2 ( ) AWS . -o sigv4 ( ) AWS . -o mp_umask ( "0000" ) umask (mount point) . allow_other s3fs . s3fs . allow_other umask . -o umask ( "0000" ) umask . . -o nomultipart - -o streamupload ( ) (stream upload) . . . . -o max_thread_count ( "10" ) head . (worker threads) . -o enable_content_md5 ( ) S3 Content-MD5 . (CPU overhead) . -o enable_unsigned_payload ( ) Content-SHA256 (payloads) PutObject UploadPart . CPU . -o ecs ( ) s3fs (instance metadata) ECS . -o iam_role ( IAM role ) IAM role "auto" . "auto" s3fs IAM role . "auto" . -o imdsv1only ( IMDSv2 v1 ) AWS IAM role API . IAM role IMDSv2 API IAM . -o ibm_iam_auth ( IBM IAM ) s3fs IBM IAM . AWSAccessKey AWSSecretKey Service- Instance-ID APIKey . -o ibm_iam_endpoint ( https://iam.cloud.ibm.com ) URL IBM IAM . -o credlib (= (shared library) . . passwd_file profile use_session_token ecs ibm_iam_auth ibm_iam_endpoint imdsv1only iam_role . -o credlib_opts (= credlib . . -o use_xattr ( ) (xattrs) . . encfs ecryptfs . : s3fs preserve=mode . -o noxmlns - xml. xml ListBucketResult ListVersionsResult . "http://s3.amazonaws.com/doc/2006-03-01" . s3fs v1.66 xmlns . -o nomixupload - . PUT (copy api) . PUT (copy api) . nocopyapi norenameapi PUT (copy api) . -o nocopyapi - . S3 API PUT (copy api) . s3fs PUT "x-amz-copy-source" (copy api) . . -o norenameapi - . S3 API PUT (copy api) . nocopyapi . nocopyapi copy- api ( chmod chown touch mv ) ( mv) copy-api . nocopyapi s3fs . -o use_path_request_style ( API) API S3 virtual-host (path request style) ..TP -o listobjectsv2 ( ListObjectsV2) ListObjectsV2 ListObjects (object stores) ListObjects . -o noua ( User-Agent) s3fs User- Agent "s3fs/ (commit hash ; )" . s3fs User-Agent . -o cipher_suites TLS. (colon) . TLS CURL : https://curl.haxx.se/docs/ssl- ciphers.html -o instance_name (instance name) s3fs. User-Agent s3fs . -o complement_stat ( /) x-amz-meta-mode s3fs / (mode) . s3fs stat . -o compat_dir ( ) s3fs "dir/" "dir" S3 . ( "/dir/file") . "dir_$folder$" . s3fs "dir/" S3 . . (bucket) s3fs s3fs . . -o use_wtf8 - . S3 UTF-8 . NFS . (codepage) <<>> UTF-8 UTF-8 . UTF-8 . -o use_session_token - . AWS_SESSION_TOKEN . -o requester_pays ( ) s3fs (Requester Pays) ( 'x-amz-request- payer=requester' ). -o mime ( "/etc/mime.types" ) mime.types . "/etc/mime.types" mime . macOS "/etc/apache2/mime.types" . -o proxy (="") S3 . '[]' . '://' 'http://' . ':' . 443 HTTPS 1080 . '--proxy(-x)' curl 'CURLOPT_PROXY' libcurl . 'http_proxy' 'all_proxy' . -o proxy_cred_file (="") ( HTTP 'proxy' ). HTTP . HTTP . ':' URL . -o ipresolve (="whatever") IP . ('whatever') IP ( IPv4 IPv6) . 'IPv4' IPv4 'IPv6' IPv6 . -o logfile - . s3fs syslog . s3fs "-f" stdout/stderr . s3fs . s3fs SIGHUP . SIGHUP (log rotation) . -o dbglevel (="crit") . crit () err () warn () info () . critical . s3fs "-d" information . s3fs SIGUSR2 . -o curldbg - curl libcurl . "normal" "body" . "normal" . "body" "normal" API . -o no_time_stamp_msg - . . "S3FS_MSGTIMESTAMP" "no" . -o set_check_cache_sigusr1 ( stdout ) (cache) (stats) . SIGUSR1 s3fs . . stdout syslog . -o update_parent_dir_stat ( ) ( inode ) mtime ctime . ..SS " (utility mode options)" -u --incomplete-mpu-list (multipart incomplete) . --incomplete-mpu-abort all (="24H") . <> . (24H) ( ). . <> <> <> <> <> <> <<1Y6M10D12h30m30s>>. FUSE/ (FUSE/MOUNT OPTIONS) (mount) 'man mount' ( ro rw suid nosuid dev nodev exec noexec atime noatime sync async dirsync). <<-onodev,nosuid>> () . FUSE allow_other. README FUSE . / (SERVER URL/REQUEST STYLE) (URL endpoint) . (<<.>>) ( <>) . Amazon S3 <> . ( <>) . (LOCAL STORAGE CONSUMPTION) s3fs () . <<-o use_cache>> s3fs s3 . . "-o use_cache" s3fs . <<-o use_cache>> . s3fs . s3fs S3 . <<-o ensure_diskfree>> . (Without local cache) s3fs s3 . (truncate) . ( 5MB <<-o multipart_size>>) (<<-o nomultipart>>) . (PERFORMANCE CONSIDERATIONS) s3fs . (backend) . << (LOCAL STORAGE CONSUMPTION)>> . (CPU and Memory Consumption) s3fs (multi-threaded) . . CPU <> . S3 (Performance of S3 requests) s3fs ( <>) . S3 . . << >> (<<-o enable_negative_cache>>) << >> (<<-o notsup_compat_dir>>) : o (<<-o enable_negative_cache>>) s3fs <<-o enable_negative_cache>> . . o (<<-o compat_dir>>) s3fs <> . s3fs <> <> . s3fs <> . o (<<-o complement_stat>>) s3fs <> . ( ). <> s3fs . (NOTES) s3fs Amazon S3 . API PUT Multipart Upload API . s3fs /etc/mime.types << >> <<>> (content-type) . S3 S3 !.SH " (SEE ALSO)" fuse(8), mount(8), fusermount(1), fstab(5) (BUGS) << >> (eventual consistency) S3 . . . s3fs FUSE s3fs . retries . . (AUTHORS) s3fs Randy Rizun . S3FS January 2026 S3FS(1)