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 @ 0.0.0.0:5244 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.

Running

Versions above v3.25.0 change the password to an encrypted hash value, and the password cannot be calculated directly. If the password is forgotten, it can only be re-randomly generated or manually set

# 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

# Obtain administrator information The following two different versions, the new version also has random generation and manual settings
# Versions lower than v3.25.0
./alist admin

# higher than v3.25.0 version
# Randomly generate a password
./alist admin random
# Manually set a password `NEW_PASSWORD` refers to the password you need to set
./alist admin set NEW_PASSWORD

Daemon

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

[Unit]
Description=alist
After=network.target
 
[Service]
Type=simple
WorkingDirectory=path_alist
ExecStart=path_alist/alist server
Restart=on-failure
 
[Install]
WantedBy=multi-user.target

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

Daemon will not use? Video Tutorialopen in new window

Info

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.