Manual installation

Andy HsuGuideInstallGuideAbout 3 min

Get Alist

Open AList Releaseopen in new window to download the files corresponding to the system to be deployed. The latest version of the front-end has been packaged with the back-end, so there is no need to download the front-end files again.

The xxxx refers to the names corresponding to different systems/architectures, generally Linux-x86/64 is alist-linux-amd64. If your glibc version is too low, it is recommended to download the musl version

When you see the output of start server @ and no error is reported afterwards, it means that the operation is successful. The initial password will be output when running for the first time. The program listens to port 5244 by default. Now open http://ip:5244 You can see the login page, please see WebDav for webdav.


# Unzip the downloaded file to get the executable file:
tar -zxvf alist-xxxx.tar.gz
# Grant program execution permissions:
chmod +x alist
# Run the program
./alist server
# Get admin's info
./alist admin


vim /usr/lib/systemd/system/alist.service add the following content, where path_alist is the path where alist is located

ExecStart=path_alist/alist server

Then systemctl daemon-reload, now you can use these commands to manage the program:

  • Start: systemctl start alist
  • Shut down: systemctl stop alist
  • Self-start: systemctl enable alist
  • Cancel Self-start: systemctl disable alist
  • Status: systemctl status alist
  • Restart: systemctl restart alist


For all platform, you can use follow command to silent start, stop and restart. (v3.4.0 and later)

# start server with `--force-bin-dir`
alist start
# stop server by pid
alist stop
# restart server by pid
alist restart

How to update

Download the new version of Alist and replace the previous one.