Skip to content

Commit

Permalink
added FAQ
Browse files Browse the repository at this point in the history
  • Loading branch information
kevinpapst committed Jan 19, 2024
1 parent 5f43af9 commit 91b81e8
Showing 1 changed file with 21 additions and 1 deletion.
22 changes: 21 additions & 1 deletion _documentation/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,8 +60,9 @@ composer install --optimize-autoloader -n

Configure the database connection and server version in the `.env` file:
```
DATABASE_URL=mysql://user:[email protected]:3306/database?charset=utf8mb4&serverVersion=5.7.40
DATABASE_URL=mysql://user:[email protected]:3306/database?charset=utf8mb4&serverVersion=11.1.2-MariaDB
```
Fetch the exact serverVersion by running `mysql --version` and copy&paste the entire version.

And run the Kimai installer:
```bash
Expand Down Expand Up @@ -145,6 +146,25 @@ you can contact me, [I offer paid setup support]({% link _store/keleo-installati

## Installation FAQ

### Column 'TABLE_NAME' in where clause is ambiguous

An error like this might occur when you have a misconfigured `serverVersion` in your `DATABASE_URL`:

```
[ERROR] Failed to set migration status: An exception occurred while executing a query: SQLSTATE[23000]: Integrity
constraint violation: 1052 Column 'TABLE_NAME' in where clause is ambiguous
```

Run `mysql --version` and extract the entire version string, for example for this entire version string:
```
mysql from 11.1.2-MariaDB, client 15.2 for osx10.19 (arm64) using EditLine wrapper
```

Your `serverVersion` should look like this:
```
DATABASE_URL=mysql://kimai:kimai@sqldb/kimai?charset=utf8mb4&serverVersion=11.1.2-MariaDB
```

### MySQL server has gone away

The message `SQLSTATE[HY000] [2006] MySQL server has gone away` usually means that your `DATABASE_URL` is wrong. You can run a command like `bin/console doctrine:schema:validate` to check,
Expand Down

0 comments on commit 91b81e8

Please sign in to comment.