The data in JuiceFS is stored in a bucket of object storage you provided, a pair of access keys should be provided when it’s mounted for the first time (each machine), which should have permission to read/write/delete objects for given bucket. The key pairs will be stored in your /root/.juicefs, never be uploaded to the JuiceFS. ( Tips: If you don’t know where is the access keys, please refer to the document How to Get Your Access Key and Secret Key from Public Cloud or Storage Provider. )

wget or curl to download the client.

Python 2.5+ or 3.x with SSL support is required.

JuiceFS requires FUSE to be mounted in Linux and macOS, Windows is not supported now. Most of Linux distributions already have FUSE module included. Otherwise, you should rebuild the kernel. For macOS, FUSE for macOS is recommended to for JuiceFS.

First of all, you should sign up a user account of JuiceFS <https://juicefs.com/accounts/register>. Second, you could create first file system now. 😍

In the above form, something you MUST attention:

Cloud Service Provider & Region: Select the cloud that you used and the region of your object storage. If the cloud or region you want is not listed, please click send a request to fill the form, normally we could support cloud within 72hrs, region within 24hrs.

OK, now you click the blue button Create, and the filesystem would be ready to mount. And you will see the screen as blew.

Next, you could mount the filesystem in the CLI of your system.

Note: When you create a filesystem, the JucieFS will create a bucket as the same name in your object storage, this bucket is used to store all of data of the filesystem.

Each filesystem of JuiceFS has a unique name (case sensitive)，a randomly generated token is used for authorization. When a filesystem is mounted for the first time on a machine, the token and access keys for given bucket of object storage will be asked (The access keys will only be remembered under /root/.juicefs, will never be sent anywhere).

For the files that are already in object storage, can be easily imported into JuiceFS, to have all the benefits of JuiceFS without moving or copying them.

They could be imported like this:

$ sudo ./juicefs import BUCKET-NAME/PREFIX TARGET-DIR-IN-JUICEFS

For example, the following command could import all the files in my-bucket with prefixmy-files into a directory my-files in JuiceFS:

$ sudo ./juicefs import my-bucket/my-files /jfs/my-files

It will only load the metadata into JuiceFS, the files are still in object storage, you can access them as usual. After importing, you can change the attributes of files (including renaming) just like they are created in JuiceFS, these change will NOT sync back into object storage, deleting an imported file in JuiceFS will NOT delete the underlying file in object storage.

Note: The same key pair is used to access imported files, please make sure that the key has read permission on the imported bucket.