BookStack/.env.example

# This file, when named as ".env" in the root of your BookStack install
# folder, is used for the core configuration of the application.
# By default this file contains the most common required options but
# a full list of options can be found in the '.env.example.complete' file.

# NOTE: If any of your values contain a space or a hash you will need to
# wrap the entire value in quotes. (eg. MAIL_FROM_NAME="BookStack Mailer")

# Application key
# Used for encryption where needed.
# Run `php artisan key:generate` to generate a valid key.
APP_KEY=SomeRandomString

# Application URL
# This must be the root URL that you want to host BookStack on.
# All URLs in BookStack will be generated using this value
# to ensure URLs generated are consistent and secure.
# If you change this in the future you may need to run a command
# to update stored URLs in the database. Command example:
# php artisan bookstack:update-url https://old.example.com https://new.example.com
APP_URL=https://example.com

# Database details
DB_HOST=localhost
DB_DATABASE=database_database
DB_USERNAME=database_username
DB_PASSWORD=database_user_password

# Mail system to use
# Can be 'smtp' or 'sendmail'
MAIL_DRIVER=smtp

# Mail sender details
MAIL_FROM_NAME="BookStack"
MAIL_FROM=bookstack@example.com

# SMTP mail options
# These settings can be checked using the "Send a Test Email"
# feature found in the "Settings > Maintenance" area of the system.
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
Updated example env with helpful info - Added comments to explain the use of the file. - Added comments to advise that space/hash containing values would need to be quoted. Related to #2258 2020-09-19 15:09:43 +00:00			`# This file, when named as ".env" in the root of your BookStack install`
			`# folder, is used for the core configuration of the application.`
			`# By default this file contains the most common required options but`
			`# a full list of options can be found in the '.env.example.complete' file.`

			`# NOTE: If any of your values contain a space or a hash you will need to`
			`# wrap the entire value in quotes. (eg. MAIL_FROM_NAME="BookStack Mailer")`

Simplified example env and created full example copy 2019-01-06 15:46:16 +00:00			`# Application key`
			`# Used for encryption where needed.`
			# Run `php artisan key:generate` to generate a valid key.
Initial commit 2015-07-12 19:01:42 +00:00			`APP_KEY=SomeRandomString`

Simplified example env and created full example copy 2019-01-06 15:46:16 +00:00			`# Application URL`
			`# This must be the root URL that you want to host BookStack on.`
Updated .env.example to encorage use of setting APP_URL For the purposes of secure URL generation and to avoid common problems found when people are using reverse proxies. 2020-12-06 12:31:36 +00:00			`# All URLs in BookStack will be generated using this value`
			`# to ensure URLs generated are consistent and secure.`
			`# If you change this in the future you may need to run a command`
			`# to update stored URLs in the database. Command example:`
			`# php artisan bookstack:update-url https://old.example.com https://new.example.com`
			`APP_URL=https://example.com`
Updated all application urls to allow path prefix. Allows BookStack to be installed at a non-root location on a domain. Closes #40. 2016-08-14 11:29:35 +00:00
Refactored Social auth into service, Made entity an abstract class 2015-09-04 16:50:52 +00:00			`# Database details`
Initial commit 2015-07-12 19:01:42 +00:00			`DB_HOST=localhost`
Refactored Social auth into service, Made entity an abstract class 2015-09-04 16:50:52 +00:00			`DB_DATABASE=database_database`
			`DB_USERNAME=database_username`
Updated readme with social & update instructions 2016-01-02 16:24:09 +00:00			`DB_PASSWORD=database_user_password`
Initial commit 2015-07-12 19:01:42 +00:00
Simplified example env and created full example copy 2019-01-06 15:46:16 +00:00			`# Mail system to use`
Updated default mail options 2020-03-14 17:32:11 +00:00			`# Can be 'smtp' or 'sendmail'`
Initial commit 2015-07-12 19:01:42 +00:00			`MAIL_DRIVER=smtp`
Simplified example env and created full example copy 2019-01-06 15:46:16 +00:00
Updated .env.example to encorage use of setting APP_URL For the purposes of secure URL generation and to avoid common problems found when people are using reverse proxies. 2020-12-06 12:31:36 +00:00			`# Mail sender details`
			`MAIL_FROM_NAME="BookStack"`
Updated default mail options 2020-03-14 17:32:11 +00:00			`MAIL_FROM=bookstack@example.com`

Simplified example env and created full example copy 2019-01-06 15:46:16 +00:00			`# SMTP mail options`
Updated example env with helpful info - Added comments to explain the use of the file. - Added comments to advise that space/hash containing values would need to be quoted. Related to #2258 2020-09-19 15:09:43 +00:00			`# These settings can be checked using the "Send a Test Email"`
			`# feature found in the "Settings > Maintenance" area of the system.`
Refactored Social auth into service, Made entity an abstract class 2015-09-04 16:50:52 +00:00			`MAIL_HOST=localhost`
			`MAIL_PORT=1025`
Initial commit 2015-07-12 19:01:42 +00:00			`MAIL_USERNAME=null`
			`MAIL_PASSWORD=null`
Allow to use DB tables prefix 2021-09-19 12:32:35 +00:00			`MAIL_ENCRYPTION=null`