Skip to content

Commit 5d0cdcd

Browse files
Update common-issues.md
1 parent 0b450e0 commit 5d0cdcd

File tree

1 file changed

+20
-6
lines changed

1 file changed

+20
-6
lines changed

installation/common-issues.md

+20-6
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,44 @@
11
## Common Problems
22

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
418

519
There are two possible options why this would happen
620
1. The mod_rewrite module is not installed or not configued properly.
721
2. Your vhost configuration does not point to the public/ folder
822

9-
**I can't upload files**
23+
### I can't upload files
1024

1125
This usually happens when PHP can't write to the local folder. Make sure userfiles/ and public/userfiles/ are writeable by the server user
1226

13-
**Folder 'vendor' cannot be found**
27+
### Folder 'vendor' cannot be found
1428

1529
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
1630

17-
**Leantime looks 'weird' after installation**
31+
### Leantime looks 'weird' after installation
1832

1933
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.
2034
1. You installed the source code and didn't execute the grunt tasks https://docs.leantime.io/#/installation/development
2135
2. You installed Leantime in a subfolder but forgot one of the steps outlined in: https://docs.leantime.io/#/installation/advanced
2236

23-
**I see `PHP Parse error: syntax error, unexpected '|', expecting ';' or '{'`**
37+
### I see `PHP Parse error: syntax error, unexpected '|', expecting ';' or '{'`**
2438

2539
You are running Leantime using PHP7.X Leantime required PHP8 to run.
2640

27-
**HX, PATCH, PUT, DELETE methods return 404**
41+
### HX, PATCH, PUT, DELETE methods return 404
2842

2943
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
3044
```

0 commit comments

Comments
 (0)