|
1 | 1 | ## Common Problems
|
2 | 2 |
|
3 |
| -**I see a 404 error when going to domain/install** |
| 3 | +First check the output of `/storage/logs/leantime-xx-xx-xx.log` |
| 4 | + |
| 5 | +### Login just refreshes (no error message) |
| 6 | + |
| 7 | +This is usually caused by 1 out of 2 commone issues: |
| 8 | +A. The session folder was removed or does not have the appropriate permissions to write sessions. For this just make sure that the session directory is owned by the php user |
| 9 | +B. `LEAN_SESSION_SECURE` is set to true but requests are served via http. `LEAN_SESSION_SECURE` forces PHP to only read cookies if they have been sent via https. If the requests comes in via http cookies will not be read. |
| 10 | +If you would like to serve Leantime via http then you must set `LEAN_SESSION_SECURE` to `false` |
| 11 | + |
| 12 | +### mkdir(): No such file or directory at ... after update |
| 13 | + |
| 14 | +One of our previous versions removed session folders to reset cache. When running the system:update command as root this caused a permission mismatch. |
| 15 | +Easiest solution is to create the folder and update Leantime to the latest version. |
| 16 | + |
| 17 | +### I see a 404 error when going to domain/install |
4 | 18 |
|
5 | 19 | There are two possible options why this would happen
|
6 | 20 | 1. The mod_rewrite module is not installed or not configued properly.
|
7 | 21 | 2. Your vhost configuration does not point to the public/ folder
|
8 | 22 |
|
9 |
| -**I can't upload files** |
| 23 | +### I can't upload files |
10 | 24 |
|
11 | 25 | This usually happens when PHP can't write to the local folder. Make sure userfiles/ and public/userfiles/ are writeable by the server user
|
12 | 26 |
|
13 |
| -**Folder 'vendor' cannot be found** |
| 27 | +### Folder 'vendor' cannot be found |
14 | 28 |
|
15 | 29 | This means that you downloaded the source code and didn't run the steps as required by the development install. Either use the release package or run the steps outlined in https://docs.leantime.io/#/installation/development
|
16 | 30 |
|
17 |
| -**Leantime looks 'weird' after installation** |
| 31 | +### Leantime looks 'weird' after installation |
18 | 32 |
|
19 | 33 | If the styles are not applied and the system looks as if it came straight from the 90s the CSS stylesheets didn't load correctly. There are 2 possible reasons for that.
|
20 | 34 | 1. You installed the source code and didn't execute the grunt tasks https://docs.leantime.io/#/installation/development
|
21 | 35 | 2. You installed Leantime in a subfolder but forgot one of the steps outlined in: https://docs.leantime.io/#/installation/advanced
|
22 | 36 |
|
23 |
| -**I see `PHP Parse error: syntax error, unexpected '|', expecting ';' or '{'`** |
| 37 | +### I see `PHP Parse error: syntax error, unexpected '|', expecting ';' or '{'`** |
24 | 38 |
|
25 | 39 | You are running Leantime using PHP7.X Leantime required PHP8 to run.
|
26 | 40 |
|
27 |
| -**HX, PATCH, PUT, DELETE methods return 404** |
| 41 | +### HX, PATCH, PUT, DELETE methods return 404 |
28 | 42 |
|
29 | 43 | More than likely your apache/iis if configured to only allow post and get http methods. We use the entire spectrum of http request methods. Please add
|
30 | 44 | ```
|
|
0 commit comments