Skip to main content


Andy HsuFAQFAQQuestionAbout 8 min

Why I got the error failed get storage: can't find storage with rawPath: / when I open web pages after install/upgrade?

Because you haven't added storage. Click the Login button at the bottom to log in and then click Manage button to enter the background and add storage on the storage page.

why i lost all my storage in v3

New versions (V3 and later) are not compatible with V2, so you need to re-add your storage.

Why I see failed get aria2 version error in log?

Because you haven't installed aria2 or the settings of aria2 are wrong. Don't worry, it won't affect the use of Alist, you can ignore it.

why i got the error Failed create storage in database: UNIQUE constraint failed: x_storages.mount_path when I add new storage?

I guess the error message is pretty clear. Because mount_path is UNIQUE.
If you see this error when adding storage, but you don't see the corresponding duplicate entry on the web page, use Ctrl + F5 to force refresh page.

Why can't I preview the video or audio file?

  • Requires a browser-supported encoding
  • General browsers do not support h265 encoded video
  • General browsers do not support ac3 encoded audio

In particular, for Safari:

  • For cross-origin media, content-type must be the media type, not the generic application/octet-stream. So if the content-type returned by the direct link is application/octet-stream, then Safari will not be able to play.(PS: Why Can AliyunDrive play in Safari? Because the official website of the video playback is not the use of download links, but after the transcoding of AliyunDrive)
  • Aliyun disk development platform driver supports online video playback (also limited to Aliyun disk open platform driver and Aliyun Video Previewer option player)

Why can't I preview the office file?

For microsoft office online viewers, you need:

  • External network access
  • The document access address cannot use ip directly, it needs to be accessed through a domain name, and the port must be port 80 / 443
  • The format of the document (must be one of the following):
  • Word: docx, docm, dotm, dotx
  • Excel: xlsx, xlsb, xls, xlsm
  • PowerPoint: pptx, ppsx, ppt, pps, pptm, potm, ppam, potx, ppsm
  • Document size: Word and PowerPoint documents must be less than 10 megabytes; Excel must be less than five megabytes

Why can't I preview the PDF file?

  • We use pdf.js as the default PDF previewer. So it requires https+cors.
  • https is opened for yourself, reverse proxy or provide a certificate in the configuration file
  • cors provides support for related cloud disks and cannot be modified by yourself unless the agent is turned on to use the program to transfer

Why can't package​ download?

Same as pdf preview, requires https+cors support,and:

  • AList use stream API of browser to support package download, so it requires browser support. Usually, it is supported by new browsers, such as Chrome, Firefox, Edge, etc.

Why does it shows Uploading in the backend when I upload a file?

  • All uploads of this program use server transfer, which will consume server traffic to communicate with the corresponding storage API

Why do i get 413 http code when i upload a file?

  • If you use a reverse proxy, you may need to specify the maximum upload file size(client_max_body_size) and timeout in the web server configuration
  • Otherwise, it may happen that the upload is successful but the front end times out and there is no response

Why can't I download files after add AliyunDirve storage and get InvalidArgument error?

  • Due to referrer restrictions, mobile tokens must be used if you don't open any proxy.

Why is the uploaded file not displayed/deleted file still/modified in the root directory does not take effect? ​

There is a half-hour cache by default, which can be modified on the Add Storage page. If you need to refresh immediately, click the refresh button in the lower right corner of the directory that needs to be refreshed.

Why is it still incorrect although I input the password that get by ./alist admin in terminal?

Check whether the directory you run ./alist admin and start alist is the same. alist reads the configuration in the current directory where you run the program by default, so running in different directorys will result in different data being read.

  • Here take Windows as an example: For example, your Alist file is in the D:\Test\Alist\ folder, and then you directly start the CMD command running window on the desktop, and then put the D drive Drag the Alist inside to the command running window to start, and then the configuration file it generates is actually in C:\Windows\System32 here (because CMD is here by default), and then you Obtaining the password is also obtaining the password in this folder. At the same time, because Alist reads the password in the configuration file in the same directory as Alist, it is naturally wrong for you to log in with the password.
    • faq
  • Solution: You need to go to the folder where Alist is located to start or check the password, for example, the above is in D:\Test\Alist\, you have to manually go to this folder and then enter Enter the startup command or the command to view the password to obtain the correct password
    • Windows: After going to the directory where Alist is located, enter CMD in the top address bar and press Enter, and then use the command to obtain the password
      • faq
    • Linux: Use the CD command to go to the directory where Alist is located to get the correct password

Why does it prompt System error: SyntaxError: Invalid regular expression: /?/: Nothing to repeat

Your Tampermonkey answering plug-in conflicts, just close it For details, click to viewopen in new window

What is the difference between the two uploads?

1️⃣ stream directly puts the binary content of the file into the body, so that the backend can use very little memory, it seem to have no downsides.

2️⃣ form is to wrap the file into formdata and upload it. The memory used by the backend will be more, but there is no limit on the size.

What is the difference between the two Aria2?

1️⃣ Background management --> Settings --> Others: Aria2 here is used to download resources offline to the network disk

2️⃣ Front-end interface --> Local settings (the gear in the lower right corner) --> Aria2 here is used to download the resources in the network disk to the local, which is equivalent to a download method, everyone can use it without worrying about problems

  • As for how to use the first offline download:
    • For example, if you want to download some resources offline in the /OneDrive/TV/Test folder, you must first fill in the address and secret key information in the background and then manually enter the front end In this folder of the interface, you can see the offline download icon (a magnet style) in the lower right corner after entering it, click and enter the link you want to download offline
    • Description: Offline download, copy and upload are all in the same way. They are first downloaded from the resource to the temporary folder of the server and then uploaded from the server to the corresponding network disk
      • "Copy" can be directly transferred by the server without temporary storage for uploads that partially do not require to calculate the Hash value.

RaiDrive mounts Baidu network disk, you can download files, but you cannot upload files. Throwing files to the mount directory prompts "Prompt "You need permission to perform this operation". How to solve this?

Raidrive is because uploading a file will create an empty file in advance, and Baidu Netdisk does not allow the creation of an empty file.
v2 can succeed because v2 ignores empty file uploads.

Why is the Terabox mounted successfully but the content is not displayed?

Because Terabox restricts IP, if you access it from a non-overseas IP, you cannot access it, and naturally the content will not be displayed.

(Overseas machines can be used. If you have to use local machines (or domestic machines) to build, you can find a way to let Alist eat proxy)

Cases where it might be useful: in new window

Open Alist prompt System error: TypeError: n.replaceAll is not a function?

Your browser kernel version is too low, just add the following to the custom head.

<!--Alist V3 suggested to add, it has been added by default, if you don't suggest adding -->
<script src=""></script>

If you think it is too slow, you can change to Ali Cloud

<script src=""></script>

Too many unsuccessful sign-in attempts have been made using an incorrect username or password, Try again later.


If you enter the wrong password for 6 consecutive logins, it will be locked, and you can reset it by restarting Alist.

When adding a file to upload, there is an option of "add as task", what does it do?

  • After checking, upload to the server (the machine where Alist is built), and then when uploaded by the server to the network disk, it seems to be visible in the background (it seems to be like this)
  • You will not see it if it is not checked. For details, you can see the problem in the picture below.


I am asked to enter the OTP code when I log in. What is the reason?

Are you logging into someone else's account? If it is your own, please enter the 2FA (two-step verification) verification code

What? Don't know the verification code? Click to view this guide

Use sqlite3 to find that there are more than two files in the data folder, data.db-shm and data.db-wal

Click to view detailed instructionsopen in new window

How do I set it so that visitors can only see the content after logging in?

There is always one of the following three versions that suits you. Eat it quickly! !

  1. Point the directory seen by guest users to an empty folder, and then write a readme description, don’t ask how to do it yourselfClick to view

  2. Directly encrypt the root directory in the meta information

  3. Directly deactivate the guest user, which will force a jump to the login page (version 3.10.1 and above)

    • Find a way by yourself Welcome to provide new ways~~

Baidu cloud disk unofficial download error appears "hit black userlist, hit illegal dlna"

It should be repaired harmoniously, but the interface discoverer said to wait for 24 hours to try, if it still doesn't work, it is really repaired harmoniously.

{"error_code":31329,"error_msg":"hit black userlist , hit illegal dlna","request_id":8942439159334999112}

How to create a completely blank folder

two ways

  1. Mount a local storage, select the folder is empty
  2. Select virtual storage and directly change "number of files" "number of folders" to 0, save and then ignore the pop-up interface
    • What does Virtual Storage do? It is generally used during testing. Don’t use it indiscriminately if you don’t understand the normal production environment....

How to add Readme instructions to an empty folder

  1. If you choose local storage, you can consider throwing a Readme.mdopen in new window file into it. If there is an update but the refresh is slow, use the second method if it is too slow
  2. Meta information Select this folder, there are instructions below to write it yourself

What is the use of creating this blank folder? It can be used in conjunction with How to set up visitors to access the content after logging in, use the first method

lib64/ version `GLIBC_2.28' not found (required by ./alist) or accept: function not implemented

Consider using the musl version as an alternative due to the version of the glibc on your platform is too low

Reference instructions:#2295open in new window#322open in new window

What is the extra sign parameter after the file now?

Encrypted for account security, you can view the details by [click to view](../config/ all)

Prompt when adding Aliyun drive (shared) Prompt Post " in new window": net/http: TLS handshake timeout

Reason: The VPS is located outside mainland China, and IPv6 is enabled
Method 1: Add the following three items in the vps hosts and restart the network or restart the vps

Method 2: Turn off and disable IPv6 of vps

123 When the cloud disk is mounted, json: cannot unmarshal string into Go struct field of type struct { Token string "json:"token"" }


There is a high probability that your device that builds Alist is temporarily blocked, frozen, blocked, or restricted. Don't mount it yet, wait a few hours and try again or wait a day

(Conclusions from the above questions have been tested)

Why doesn't PikPak have a name

Because PikPak's server does not set the filename in the content-disposition header, this is a PikPak problem and not an AList, so it cannot be fixed

How to query your own AList version number

  1. Use the command alist version, the console will output
  2. AList Manage --> Settings --> Site --> Version option

Why is the old version of AList still after the update? Generally, docker encounters this problem. You can refer to the QA answer mentioned below

AList's download "Download" option suddenly blank, no content

Check your plug-ins, whether there are ad blocking plug-ins, for example: AdGuard and others

Through the console, it is found that " in new window" has been blocked,

Maybe other links are blocked, manually add the blocked domain name to the whitelist or close the plug-in, or it may be that the plug-in is convulsed


Why is the text file garbled?

Only utf-8 encoding is supported. See also: #4131open in new window