Storage

If you need to use file storage services such as avatar upload, you need to set up a storage provider and apply it in your application.

Casdoor supports two types of storage, Local and Cloud. In this chapter you will learn how to add a storage provider to use these services.

Local

With Local type, the Client ID, Client secret, Endpoint and Bucket field is no longer needed, you can fill in it at will, and it cannot be empty.

The only item that you need to configure is Domain field, please follow the format:

  1. Domain/images

For example, http://127.0.0.1:7001/images, http://door.casbin.org/images are all allowed.

But 127.0.0.1:7001/images is wrong.

Cloud-Based

Currently we support AWS S3 and Aliyun OSS cloud vendors, and are adding more Cloud storage services.

Fill in the corresponding fields with Client ID, Client secret, Endpoint and Bucket obtained from your cloud vendor console.

tip

With Non-local type, you probably don’t need the Domain field, which is used for custom domain.

Example

note

Here, I use Aliyun OSS as an example

The AccessKey is your key to access Aliyun API, with full account permissions.

So created AccessKey in Aliyun workbench.

Then create OSS service:

Create OSS

Fill the necessary information in Casdoor and save:

OSS

Then you can use Aliyun cloud storage services in your application.