How to

Noah HsuSeptember 7, 2022
  • FAQ
  • FAQ
  • Question
About 1 min

How to add password for a file/folder?

Add a meta record.

How to reverse proxy with sub directory?

An example of using nginx to reverse proxy to in new window

  • Normal installation
  • Set Api url to, Base path to alist and click save button
  • Add a reverse proxy record in nginx
location /alist/ {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Range $http_range;
	  proxy_set_header If-Range $http_if_range;
    proxy_redirect off;
    # the max size of file to upload
    client_max_body_size 20000m;

How to get password if i forget it?

If you are the owner of the site, you can get the admin's info by run ./alist admin in the terminal. Otherwise you can ask the owner to reset the password.

How to modify the listening port​

Refer to config

How to upgrade

Except for the incompatible version marked in the changelog, you can directly replace the binary file to upgrade.

For docker user, just remove the old container and pull the new image then run it.

How to allow guest to upload files

Add a meta record, and open write field.

How to remove powered_by Alist at the bottom?​

Please respect the developer's labor, thank you. If you really want to remove it, you can use customize css to hide it.

When adding a 189Cloud storage: the device ID does not exist, and a secondary device verification is required​

It may be that the prevention and control has been triggered. After changing the password, add it again.