You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Versions above 3.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`**
32
-
33
-
```bash
34
-
# Randomly generate a password
35
-
docker exec -it alist ./alist admin random
36
-
# Manually set a password, `NEW_PASSWORD` refers to the password you need to set
37
-
docker exec -it alist ./alist admin set NEW_PASSWORD
**Alternatively, you can manually create a `docker-compose.yml` file with the following content.**
29
+
#### **docker compose**
58
30
59
31
```yaml
60
32
version: '3.3'
61
33
services:
62
-
alist:
63
-
image: 'xhofe/alist:latest'
64
-
container_name: alist
65
-
volumes:
66
-
- '/etc/alist:/opt/alist/data'
67
-
ports:
68
-
- '5244:5244'
69
-
environment:
70
-
- PUID=0
71
-
- PGID=0
72
-
- UMASK=022
73
-
restart: unless-stopped
34
+
alist:
35
+
image: 'xhofe/alist:beta'
36
+
container_name: alist
37
+
volumes:
38
+
- '/etc/alist:/opt/alist/data'
39
+
ports:
40
+
- '5244:5244'
41
+
environment:
42
+
- PUID=0
43
+
- PGID=0
44
+
- UMASK=022
45
+
restart: unless-stopped
74
46
```
75
-
After the service runs, the default time zone for the container is UTC time zone. If you want to specify the time zone for the container to run, you can achieve this by passing this variable:`-e "TZ=Asia/Shanghai"`。
76
-
77
-
### **Offline download with aria2**
78
47
79
-
If you want to use aria2 to offline download, we recommend you to use this [image](https://hub.docker.com/r/xhofe/alist-aria2), which carries a pre-installed aria2.
48
+
#### **Env**
80
49
81
-
### **Dev version**
82
-
Just for amd64/arm64. Not recommended, this may can't work properly.
| `aio` | An image that includes all of the following pre-installed environments. |
71
+
| `ffmpeg` | Pre-installed FFmpeg image for generating thumbnail for local storage |
72
+
| `aria2` | Pre-installed aria2 image for offline downloading. |
113
73
114
-
You can switch to image with out-of-the-box ffmpeg environment by adding `-ffmpeg` to any image tag.
74
+
You can append a suffix using the `-` symbol after any of the mirror tags to switch to an image with the corresponding environment. For example, `xhofe/alist:latest-aio` `xhofe/alist:beta-aria2` `xhofe/alist:v3.40.0-ffmpeg`
115
75
116
-
If the thumbnail feature is still not working, please verify the following:
76
+
If the thumbnail generation function still does not work when using the pre-installed ffmpeg, please confirm:
117
77
118
78
+ You are using local storage
119
79
+ Switched to grid view
120
80
+ The thumbnail switch in local storage driver settings is enabled
121
81
+ The configuration path for the thumbnail cache folder in local storage is correct, for example, `data/thumbnail`
122
82
123
-
::: tabs#Docker-ffmpeg
83
+
When using a pre-installed aria2 mirror, you might see errors like the following in the alist logs:
124
84
125
-
@tab latest
85
+
```
86
+
ERRO[2022-11-20 12:05:19] error [unaligned 64-bit atomic operation] while run task [download http://xxx.com/xxx.png to [/ftp](/)]
87
+
```
126
88
127
-
**docker-cli**
89
+
The solution is, if the CPU architecture is 64-bit, you can try to manually pull a 64-bit image or rebuild the container. If the CPU architecture is 32-bit, there is currently no available solution.
Versions above 3.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`**
# Manually set a password, `NEW_PASSWORD` refers to the password you need to set
107
+
docker exec -it alist ./alist admin set NEW_PASSWORD
158
108
```
159
109
160
-
**docker-compose**
161
-
162
-
```bash
163
-
version: '3.3'
164
-
services:
165
-
alist:
166
-
image: 'xhofe/alist:beta-ffmpeg'
167
-
container_name: alist
168
-
volumes:
169
-
- '/etc/alist:/opt/alist/data'
170
-
ports:
171
-
- '5244:5244'
172
-
environment:
173
-
- PUID=0
174
-
- PGID=0
175
-
- UMASK=022
176
-
restart: unless-stopped
177
-
```
110
+
## **Update**
111
+
::: details docker-cli update
112
+
1. docker ps -a #View the container (find the ID of the Alist container)
113
+
2. docker stop ID #Stop Alist running, otherwise it cannot be deleted (this time the ID of the Alist container is d429749a6e69, it is different for each installation)
114
+
3. docker rm ID #Delete the Alist container (the data is still there as long as you don't delete it manually)
115
+
4. docker pull xhofe/alist:latest
116
+
5.[Enter the installation command and click to view](#docker-cli)
117
+
6. The update is complete, go and have a look.. It's that simple
178
118
119
+
**There is a missing step in the picture, it is step 4 in the tutorial....remember to execute**
120
+
179
121
:::
180
122
181
-
### **User / Group Identifiers**
123
+
:::details docker-compose update
124
+
1. docker-compose pull
182
125
183
-
When using volumes (`-v` flags) permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user `PUID` and group `PGID`.
126
+
2. docker-compose up -d
184
127
185
-
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
128
+
:::
186
129
187
-
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as below:
130
+
Q: My version is v3.x.x and I cannot upgrade to the latest version. `docker pull xhofe/alist:latest` does not work to pull the latest version. After changing to docker-compose, it is still version 3.x.x
A: The reason is that your docker has set up a mirror, and the latest version cannot be updated from the mirror, so modify /etc/docker/daemon.json and delete "registry-mirrors": ["mirror accelerator address"]
133
+
134
+
- If deletion doesn’t work, you can consider replacing it with a `mirror acceleration address`
135
+
- Or simple and rude: when downloading, replace `xhofe/alist:latest` with `xhofe/alist:v3.16.3` (specify the version, the latest when writing the tutorial is 3.16.3)
193
136
194
-
### **Manually build Docker image**
137
+
### **Compile Image**
195
138
196
-
Install Docker, clone the repository, and navigate to the root directory of the repository, no additional preparation is needed.
139
+
Install Docker, clone the repository, then navigate to the root directory of the repository. No further preparation is required.
197
140
198
141
::: tabs#Docker-build
199
142
@@ -203,52 +146,18 @@ Install Docker, clone the repository, and navigate to the root directory of the
## **Additional notes about the offline download feature**
215
-
216
-
If the image is not pulled using the '''docker pull --platform''' parameter, docker may pull the 32-bit image on the 64-bit operating system, which may cause the offline download function to be unavailable even under normal configuration.
217
-
218
-
When an error occurs, you will see a similar error log in Alist's log file.
219
-
220
-
```ERRO[2022-11-20 12:05:19] error [unaligned 64-bit atomic operation] while run task [download http://pic.rmb.bdstatic.com/bjh/34ee946f7a74435a167ca4351d723374.png to [/ftp](/)]```
221
-
222
-
Solution, if the CPU architecture is 64-bit, try to manually pull the 64-bit docker image, rebuild the container, and try again.
223
-
224
-
If the CPU architecture is 32-bit, there is currently no solution available.
225
-
226
-
227
-
228
-
## **How to update Docker installation?**
229
-
230
-
::: details docker-cli update
231
-
1. docker ps -a #View the container (find the ID of the Alist container)
232
-
2. docker stop ID #Stop Alist running, otherwise it cannot be deleted (this time the ID of the Alist container is d429749a6e69, it is different for each installation)
233
-
3. docker rm ID #Delete the Alist container (the data is still there as long as you don't delete it manually)
234
-
4. docker pull xhofe/alist:latest
235
-
5. [Enter the installation command and click to view](#docker-cli)
236
-
6. The update is complete, go and have a look.. It's that simple
237
-
238
-
**There is a missing step in the picture, it is step 4 in the tutorial....remember to execute**
239
-
240
-
:::
241
-
242
-
:::details docker-compose update
243
-
1. docker-compose pull
244
-
245
-
2. docker-compose up -d
246
-
247
-
:::
248
-
249
-
Q: My version is v3.x.x and I cannot upgrade to the latest version. `docker pull xhofe/alist:latest` does not work to pull the latest version. After changing to docker-compose, it is still version 3.x.x
250
157
251
-
A: The reason is that your docker has set up a mirror, and the latest version cannot be updated from the mirror, so modify /etc/docker/daemon.json and delete "registry-mirrors": ["mirror accelerator address"]
158
+
Available build args:
252
159
253
-
- If deletion doesn’t work, you can consider replacing it with a `mirror acceleration address`
254
-
- Or simple and rude: when downloading, replace `xhofe/alist:latest` with `xhofe/alist:v3.16.3` (specify the version, the latest when writing the tutorial is 3.16.3)
0 commit comments