AList

Admin Setup (Required)

No admin user is created automatically.

Create or set the admin password:

docker exec -it alist ./alist admin set <NEW_PASSWORD>

Or generate a random password:

docker exec -it alist ./alist admin random

Access

• Main interface: http://<SERVER-IP>
• Management panel: http://<SERVER-IP>/@manage
• Log in using admin and the password you set during admin setup.

Important Files & Directories

• Application installation: /root/alist
• Docker Compose file: /root/alist/docker-compose.yml
• Caddy configuration: /root/alist/Caddyfile
• AList persistent data: /etc/alist
• Caddy data volume: /var/lib/docker/volumes/alist_caddy_data/_data
• Caddy config volume: /var/lib/docker/volumes/alist_caddy_config/_data

Docker & Service Management

List containers:

docker ps

Start or recreate services:

docker compose -f /root/alist/docker-compose.yml up -d

Restart AList:

docker compose -f /root/alist/docker-compose.yml restart

Follow logs:

docker compose -f /root/alist/docker-compose.yml logs -f

Storage Management

Show all configured storage backends and their status:

docker exec -it alist ./alist storage list

Disable a specific storage mount (example: /pikpak):

docker exec -it alist ./alist storage disable /pikpak

Domain & HTTPS (Caddy)

0. HTTPS does NOT work with IP addresses.

1. Point a domain (e.g. alist.example.com) to this server.

2. Update Caddyfile:

alist.example.com {
    reverse_proxy alist:5244
}

3. Restart services:

docker compose -f /root/alist/docker-compose.yml restart

4. Caddy will automatically issue and renew SSL certificates.