Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902)

.env.dist

@@ -1,16 +1,47 @@
-# Configure your database connection and set the correct server version:
-# for MySQL "serverVersion=5.7" and for MariaDB "serverVersion=mariadb-10.5.8"
+#
+# You should NOT use this file in production, but instead move the environment variables to your webserver configuration.
+# The .env file is only existing to simplify the initial setup!
+#
+
+#================================================================================
+# Configure your database connection and set the correct server version.
+#
+# You have to replace the following values with your defaults:
+# - the version "5.7"
+# - the database username "user"
+# - the database password "password"
+# - the database schema name "database"
+# - you might have to adapt port "3306" and server IP "127.0.0.1" as well
+#
+# For MySQL that would be "serverVersion=5.7" as in:
+#    DATABASE_URL=mysql://user:password@127.0.0.1:3306/database?charset=utf8&serverVersion=5.7
+#
+# For MariaDB it would be "serverVersion=mariadb-10.5.8":
+#    DATABASE_URL=mysql://user:password@127.0.0.1:3306/database?charset=utf8&serverVersion=mariadb-10.5.8
+#
 DATABASE_URL=mysql://user:password@127.0.0.1:3306/database?charset=utf8&serverVersion=5.7
-# Email will be sent with this address as sender
+
+#================================================================================
+# The full documentation can be found at https://www.kimai.org/documentation/emails.html
+#
+# Email will be sent with this address as sender:
 MAILER_FROM=kimai@example.com
-# Email connection (disabled by default) more info at https://www.kimai.org/documentation/emails.html
+# Email connection (disabled by default) - see documentation for the format
 MAILER_URL=null://null
+
+#================================================================================
 # do not change, unless you are developing for Kimai
 APP_ENV=prod
-# should be changed to a unique character sequence
+
+#================================================================================
+# should be changed to a unique character sequence, used for hashing cookies
 APP_SECRET=change_this_to_something_unique
-# unlikely, that you need to change this one
-CORS_ALLOW_ORIGIN=^https?://localhost(:[0-9]+)?$
-# Running behind reverse proxies? Use those:
+
+#================================================================================
+# Running behind reverse proxies? Try these:
 # TRUSTED_PROXIES=127.0.0.1,127.0.0.2
 # TRUSTED_HOSTS=localhost,example.com
+
+#================================================================================
+# unlikely, that you need to change this one
+CORS_ALLOW_ORIGIN=^https?://localhost(:[0-9]+)?$