From 5b73c3b2dc06f1307893d8c0b8834cee0d97afee Mon Sep 17 00:00:00 2001 From: Anthony D'Atri Date: Sat, 15 Nov 2025 01:33:47 -0500 Subject: [PATCH 1/4] doc: Improve docs/en/faq.md Signed-off-by: Anthony D'Atri --- docs/en/faq.md | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/en/faq.md b/docs/en/faq.md index f6694849c6f3..106cc266c636 100644 --- a/docs/en/faq.md +++ b/docs/en/faq.md @@ -122,7 +122,9 @@ Read [JuiceFS Internals](development/internals.md) and [Data Processing Flow](in ### How to copy a large number of small files into JuiceFS quickly? -You could mount JuiceFS with [`--writeback` option](reference/command_reference.mdx#mount-data-cache-options), which will write the small files into local disks first, then upload them to object storage in background, this could speedup coping many small files into JuiceFS. +Mount JuiceFS with the [`--writeback` option](reference/command_reference.mdx#mount-data-cache-options), +which will stage the small files on local storage, then flush them to backing +storage in background. See ["Write Cache in Client"](guide/cache.md#client-write-cache) for more information. @@ -132,15 +134,15 @@ See ["Write Cache in Client"](guide/cache.md#client-write-cache) for more inform ## Mount Related Questions -### Can I mount JuiceFS without `root`? +### Can I mount JuiceFS without `root` privileges? -Yes, JuiceFS could be mounted using `juicefs` without root. The default directory for caching is `$HOME/.juicefs/cache` (macOS) or `/var/jfsCache` (Linux), you should change that to a directory which you have write permission. +Yes, JuiceFS could be mounted using `juicefs` without root privileges. The default directory for caching is `$HOME/.juicefs/cache` (macOS) or `/var/jfsCache` (Linux), you should change that to a directory which you have write permission. See ["Read Cache in Client"](guide/cache.md#client-read-cache) for more information. ## Access Related Questions -### What other ways JuiceFS supports access to data besides mount? +### What other ways does JuiceFS offer to access data? In addition to mounting, the following methods are also supported: @@ -150,9 +152,9 @@ In addition to mounting, the following methods are also supported: - Docker Volume Plugin: A convenient way to use JuiceFS in Docker, please refer to ["Use JuiceFS on Docker"](deployment/juicefs_on_docker.md). - WebDAV Gateway: Access JuiceFS via WebDAV protocol -### Why the same user on host X has permission to access a file in JuiceFS while has no permission to it on host Y? +### Why does a user on host X have permission to access a file in JuiceFS, but does not on host Y? -The same user has different UID or GID on host X and host Y. Use `id` command to show the UID and GID: +Most likely the user has a different numeric UID or GID on the two hosts. Use the `id` command on each host to show each symbolic and numeric UID and GID: ```bash $ id alice @@ -161,10 +163,10 @@ uid=1201(alice) gid=500(staff) groups=500(staff) Read ["Sync Accounts between Multiple Hosts"](administration/sync_accounts_between_multiple_hosts.md) to resolve this problem. -### Does JuiceFS Gateway support advanced features such as multi-user management? +### Does the JuiceFS Gateway support advanced features such as multi-user management? -The built-in `gateway` subcommand of JuiceFS does not support functions such as multi-user management, and only provides basic S3 gateway functions. If you need to use these advanced features, please refer to the [documentation](guide/gateway.md). +The built-in `gateway` subcommand does not support functions including as multi-user management, and provides only basic S3 gateway functions. If you need to use these advanced features, please refer to the [documentation](guide/gateway.md). -### Is there currently an SDK available for JuiceFS? +### Is there an SDK available for JuiceFS? As of the release of JuiceFS 1.0, the community has two SDKs, one is the [Java SDK](deployment/hadoop_java_sdk.md) that is highly compatible with the HDFS interface officially maintained by Juicedata, and the other is the [Python SDK](https://github.com/megvii-research/juicefs-python) maintained by community users. From 82551edeb74ac0b2c992601ac4f4f70982e58f78 Mon Sep 17 00:00:00 2001 From: Caitin <34535727+CaitinChen@users.noreply.github.com> Date: Mon, 24 Nov 2025 12:00:19 +0800 Subject: [PATCH 2/4] docs: update format --- docs/en/faq.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/docs/en/faq.md b/docs/en/faq.md index 106cc266c636..89620874248a 100644 --- a/docs/en/faq.md +++ b/docs/en/faq.md @@ -122,11 +122,8 @@ Read [JuiceFS Internals](development/internals.md) and [Data Processing Flow](in ### How to copy a large number of small files into JuiceFS quickly? -Mount JuiceFS with the [`--writeback` option](reference/command_reference.mdx#mount-data-cache-options), -which will stage the small files on local storage, then flush them to backing -storage in background. - -See ["Write Cache in Client"](guide/cache.md#client-write-cache) for more information. +Mount JuiceFS with the [`--writeback` option](reference/command_reference.mdx#mount-data-cache-options), which will stage the small files on local storage, then flush them to backing +storage in background. See ["Write Cache in Client"](guide/cache.md#client-write-cache) for more information. ### Does JuiceFS support distributed cache? From 9ccbe70055bc4642b448e85fd2cbae710a8d62e2 Mon Sep 17 00:00:00 2001 From: Caitin <34535727+CaitinChen@users.noreply.github.com> Date: Mon, 24 Nov 2025 12:13:37 +0800 Subject: [PATCH 3/4] Update faq.md --- docs/en/faq.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/en/faq.md b/docs/en/faq.md index 89620874248a..9e0410744888 100644 --- a/docs/en/faq.md +++ b/docs/en/faq.md @@ -122,8 +122,7 @@ Read [JuiceFS Internals](development/internals.md) and [Data Processing Flow](in ### How to copy a large number of small files into JuiceFS quickly? -Mount JuiceFS with the [`--writeback` option](reference/command_reference.mdx#mount-data-cache-options), which will stage the small files on local storage, then flush them to backing -storage in background. See ["Write Cache in Client"](guide/cache.md#client-write-cache) for more information. +Use the [`--writeback` option](reference/command_reference.mdx#mount-data-cache-options) to write data to the local cache and then asynchronously upload it to the object storage backend. This is significantly faster than writing directly to object storage. See ["Write Cache in Client"](guide/cache.md#client-write-cache) for more information. ### Does JuiceFS support distributed cache? From 2aeb4a7f169ba30ed6768a583f12af931ad6e2b9 Mon Sep 17 00:00:00 2001 From: Caitin <34535727+CaitinChen@users.noreply.github.com> Date: Mon, 24 Nov 2025 14:35:33 +0800 Subject: [PATCH 4/4] Update docs/en/faq.md --- docs/en/faq.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/faq.md b/docs/en/faq.md index 9e0410744888..7d3d69459913 100644 --- a/docs/en/faq.md +++ b/docs/en/faq.md @@ -159,7 +159,7 @@ uid=1201(alice) gid=500(staff) groups=500(staff) Read ["Sync Accounts between Multiple Hosts"](administration/sync_accounts_between_multiple_hosts.md) to resolve this problem. -### Does the JuiceFS Gateway support advanced features such as multi-user management? +### Does JuiceFS S3 Gateway support advanced features such as multi-user management? The built-in `gateway` subcommand does not support functions including as multi-user management, and provides only basic S3 gateway functions. If you need to use these advanced features, please refer to the [documentation](guide/gateway.md).