]> BookStack Code Mirror - bookstack/blob - .env.example.complete
Fixed failing webhook test cases
[bookstack] / .env.example.complete
1 # Full list of environment variables that can be used with BookStack.
2 # Selectively copy these to your '.env' file as required.
3 # Each option is shown with it's default value.
4 # Do not copy this whole file to use as your '.env' file.
5
6 # Application environment
7 # Can be 'production', 'development', 'testing' or 'demo'
8 APP_ENV=production
9
10 # Enable debug mode
11 # Shows advanced debug information and errors.
12 # CAN EXPOSE OTHER VARIABLES, LEAVE DISABLED
13 APP_DEBUG=false
14
15 # Application key
16 # Used for encryption where needed.
17 # Run `php artisan key:generate` to generate a valid key.
18 APP_KEY=SomeRandomString
19
20 # Application URL
21 # This must be the root URL that you want to host BookStack on.
22 # All URL's in BookStack will be generated using this value.
23 APP_URL=https://example.com
24
25 # Application default language
26 # The default language choice to show.
27 # May be overridden by user-preference or visitor browser settings.
28 APP_LANG=en
29
30 # Auto-detect language for public visitors.
31 # Uses browser-sent headers to infer a language.
32 # APP_LANG will be used if such a header is not provided.
33 APP_AUTO_LANG_PUBLIC=true
34
35 # Application timezone
36 # Used where dates are displayed such as on exported content.
37 # Valid timezone values can be found here: https://www.php.net/manual/en/timezones.php
38 APP_TIMEZONE=UTC
39
40 # Application theme
41 # Used to specific a themes/<APP_THEME> folder where BookStack UI
42 # overrides can be made. Defaults to disabled.
43 APP_THEME=false
44
45 # Trusted Proxies
46 # Used to indicate trust of systems that proxy to the application so
47 # certain header values (Such as "X-Forwarded-For") can be used from the
48 # incoming proxy request to provide origin detail.
49 # Set to an IP address, or multiple comma seperated IP addresses.
50 # Can alternatively be set to "*" to trust all proxy addresses.
51 APP_PROXIES=null
52
53 # Database details
54 # Host can contain a port (localhost:3306) or a separate DB_PORT option can be used.
55 DB_HOST=localhost
56 DB_PORT=3306
57 DB_DATABASE=database_database
58 DB_USERNAME=database_username
59 DB_PASSWORD=database_user_password
60
61 # Mail system to use
62 # Can be 'smtp' or 'sendmail'
63 MAIL_DRIVER=smtp
64
65 # Mail sending options
66 MAIL_FROM=mail@bookstackapp.com
67 MAIL_FROM_NAME=BookStack
68
69 # SMTP mail options
70 MAIL_HOST=localhost
71 MAIL_PORT=1025
72 MAIL_USERNAME=null
73 MAIL_PASSWORD=null
74 MAIL_ENCRYPTION=null
75
76 # Cache & Session driver to use
77 # Can be 'file', 'database', 'memcached' or 'redis'
78 CACHE_DRIVER=file
79 SESSION_DRIVER=file
80
81 # Session configuration
82 SESSION_LIFETIME=120
83 SESSION_COOKIE_NAME=bookstack_session
84 SESSION_SECURE_COOKIE=false
85
86 # Cache key prefix
87 # Can be used to prevent conflicts multiple BookStack instances use the same store.
88 CACHE_PREFIX=bookstack
89
90 # Memcached server configuration
91 # If using a UNIX socket path for the host, set the port to 0
92 # This follows the following format: HOST:PORT:WEIGHT
93 # For multiple servers separate with a comma
94 MEMCACHED_SERVERS=127.0.0.1:11211:100
95
96 # Redis server configuration
97 # This follows the following format: HOST:PORT:DATABASE
98 # or, if using a password: HOST:PORT:DATABASE:PASSWORD
99 # For multiple servers separate with a comma. These will be clustered.
100 REDIS_SERVERS=127.0.0.1:6379:0
101
102 # Queue driver to use
103 # Can be 'sync', 'database' or 'redis'
104 QUEUE_CONNECTION=sync
105
106 # Storage system to use
107 # Can be 'local', 'local_secure' or 's3'
108 STORAGE_TYPE=local
109
110 # Image storage system to use
111 # Defaults to the value of STORAGE_TYPE if unset.
112 # Accepts the same values as STORAGE_TYPE.
113 STORAGE_IMAGE_TYPE=local
114
115 # Attachment storage system to use
116 # Defaults to the value of STORAGE_TYPE if unset.
117 # Accepts the same values as STORAGE_TYPE although 'local' will be forced to 'local_secure'.
118 STORAGE_ATTACHMENT_TYPE=local_secure
119
120 # Amazon S3 storage configuration
121 STORAGE_S3_KEY=your-s3-key
122 STORAGE_S3_SECRET=your-s3-secret
123 STORAGE_S3_BUCKET=s3-bucket-name
124 STORAGE_S3_REGION=s3-bucket-region
125
126 # S3 endpoint to use for storage calls
127 # Only set this if using a non-Amazon s3-compatible service such as Minio
128 STORAGE_S3_ENDPOINT=https://my-custom-s3-compatible.service.com:8001
129
130 # Storage URL prefix
131 # Used as a base for any generated image urls.
132 # An s3-format URL will be generated if not set.
133 STORAGE_URL=false
134
135 # Authentication method to use
136 # Can be 'standard', 'ldap', 'saml2' or 'oidc'
137 AUTH_METHOD=standard
138
139 # Social authentication configuration
140 # All disabled by default.
141 # Refer to https://www.bookstackapp.com/docs/admin/third-party-auth/
142
143 AZURE_APP_ID=false
144 AZURE_APP_SECRET=false
145 AZURE_TENANT=false
146 AZURE_AUTO_REGISTER=false
147 AZURE_AUTO_CONFIRM_EMAIL=false
148
149 DISCORD_APP_ID=false
150 DISCORD_APP_SECRET=false
151 DISCORD_AUTO_REGISTER=false
152 DISCORD_AUTO_CONFIRM_EMAIL=false
153
154 FACEBOOK_APP_ID=false
155 FACEBOOK_APP_SECRET=false
156 FACEBOOK_AUTO_REGISTER=false
157 FACEBOOK_AUTO_CONFIRM_EMAIL=false
158
159 GITHUB_APP_ID=false
160 GITHUB_APP_SECRET=false
161 GITHUB_AUTO_REGISTER=false
162 GITHUB_AUTO_CONFIRM_EMAIL=false
163
164 GITLAB_APP_ID=false
165 GITLAB_APP_SECRET=false
166 GITLAB_BASE_URI=false
167 GITLAB_AUTO_REGISTER=false
168 GITLAB_AUTO_CONFIRM_EMAIL=false
169
170 GOOGLE_APP_ID=false
171 GOOGLE_APP_SECRET=false
172 GOOGLE_SELECT_ACCOUNT=false
173 GOOGLE_AUTO_REGISTER=false
174 GOOGLE_AUTO_CONFIRM_EMAIL=false
175
176 OKTA_BASE_URL=false
177 OKTA_APP_ID=false
178 OKTA_APP_SECRET=false
179 OKTA_AUTO_REGISTER=false
180 OKTA_AUTO_CONFIRM_EMAIL=false
181
182 SLACK_APP_ID=false
183 SLACK_APP_SECRET=false
184 SLACK_AUTO_REGISTER=false
185 SLACK_AUTO_CONFIRM_EMAIL=false
186
187 TWITCH_APP_ID=false
188 TWITCH_APP_SECRET=false
189 TWITCH_AUTO_REGISTER=false
190 TWITCH_AUTO_CONFIRM_EMAIL=false
191
192 TWITTER_APP_ID=false
193 TWITTER_APP_SECRET=false
194 TWITTER_AUTO_REGISTER=false
195 TWITTER_AUTO_CONFIRM_EMAIL=false
196
197 # LDAP authentication configuration
198 # Refer to https://www.bookstackapp.com/docs/admin/ldap-auth/
199 LDAP_SERVER=false
200 LDAP_BASE_DN=false
201 LDAP_DN=false
202 LDAP_PASS=false
203 LDAP_USER_FILTER=false
204 LDAP_VERSION=false
205 LDAP_START_TLS=false
206 LDAP_TLS_INSECURE=false
207 LDAP_ID_ATTRIBUTE=uid
208 LDAP_EMAIL_ATTRIBUTE=mail
209 LDAP_DISPLAY_NAME_ATTRIBUTE=cn
210 LDAP_THUMBNAIL_ATTRIBUTE=null
211 LDAP_FOLLOW_REFERRALS=true
212 LDAP_DUMP_USER_DETAILS=false
213
214 # LDAP group sync configuration
215 # Refer to https://www.bookstackapp.com/docs/admin/ldap-auth/
216 LDAP_USER_TO_GROUPS=false
217 LDAP_GROUP_ATTRIBUTE="memberOf"
218 LDAP_REMOVE_FROM_GROUPS=false
219
220 # SAML authentication configuration
221 # Refer to https://www.bookstackapp.com/docs/admin/saml2-auth/
222 SAML2_NAME=SSO
223 SAML2_EMAIL_ATTRIBUTE=email
224 SAML2_DISPLAY_NAME_ATTRIBUTES=username
225 SAML2_EXTERNAL_ID_ATTRIBUTE=null
226 SAML2_IDP_ENTITYID=null
227 SAML2_IDP_SSO=null
228 SAML2_IDP_SLO=null
229 SAML2_IDP_x509=null
230 SAML2_ONELOGIN_OVERRIDES=null
231 SAML2_DUMP_USER_DETAILS=false
232 SAML2_AUTOLOAD_METADATA=false
233 SAML2_IDP_AUTHNCONTEXT=true
234 SAML2_SP_x509=null
235 SAML2_SP_x509_KEY=null
236
237 # SAML group sync configuration
238 # Refer to https://www.bookstackapp.com/docs/admin/saml2-auth/
239 SAML2_USER_TO_GROUPS=false
240 SAML2_GROUP_ATTRIBUTE=group
241 SAML2_REMOVE_FROM_GROUPS=false
242
243 # OpenID Connect authentication configuration
244 # Refer to https://www.bookstackapp.com/docs/admin/oidc-auth/
245 OIDC_NAME=SSO
246 OIDC_DISPLAY_NAME_CLAIMS=name
247 OIDC_CLIENT_ID=null
248 OIDC_CLIENT_SECRET=null
249 OIDC_ISSUER=null
250 OIDC_ISSUER_DISCOVER=false
251 OIDC_PUBLIC_KEY=null
252 OIDC_AUTH_ENDPOINT=null
253 OIDC_TOKEN_ENDPOINT=null
254 OIDC_DUMP_USER_DETAILS=false
255
256 # Disable default third-party services such as Gravatar and Draw.IO
257 # Service-specific options will override this option
258 DISABLE_EXTERNAL_SERVICES=false
259
260 # Use custom avatar service, Sets fetch URL
261 # Possible placeholders: ${hash} ${size} ${email}
262 # If set, Avatars will be fetched regardless of DISABLE_EXTERNAL_SERVICES option.
263 # Example: AVATAR_URL=https://seccdn.libravatar.org/avatar/${hash}?s=${size}&d=identicon
264 AVATAR_URL=
265
266 # Enable diagrams.net integration
267 # Can simply be true/false to enable/disable the integration.
268 # Alternatively, It can be URL to the diagrams.net instance you want to use.
269 # For URLs, The following URL parameters should be included: embed=1&proto=json&spin=1
270 DRAWIO=true
271
272 # Default item listing view
273 # Used for public visitors and user's without a preference.
274 # Can be 'list' or 'grid'.
275 APP_VIEWS_BOOKS=list
276 APP_VIEWS_BOOKSHELVES=grid
277 APP_VIEWS_BOOKSHELF=grid
278
279 # Use dark mode by default
280 # Will be overriden by any user/session preference.
281 APP_DEFAULT_DARK_MODE=false
282
283 # Page revision limit
284 # Number of page revisions to keep in the system before deleting old revisions.
285 # If set to 'false' a limit will not be enforced.
286 REVISION_LIMIT=50
287
288 # Recycle Bin Lifetime
289 # The number of days that content will remain in the recycle bin before
290 # being considered for auto-removal. It is not a guarantee that content will
291 # be removed after this time.
292 # Set to 0 for no recycle bin functionality.
293 # Set to -1 for unlimited recycle bin lifetime.
294 RECYCLE_BIN_LIFETIME=30
295
296 # File Upload Limit
297 # Maximum file size, in megabytes, that can be uploaded to the system.
298 FILE_UPLOAD_SIZE_LIMIT=50
299
300 # Allow <script> tags in page content
301 # Note, if set to 'true' the page editor may still escape scripts.
302 ALLOW_CONTENT_SCRIPTS=false
303
304 # Indicate if robots/crawlers should crawl your instance.
305 # Can be 'true', 'false' or 'null'.
306 # The behaviour of the default 'null' option will depend on the 'app-public' admin setting.
307 # Contents of the robots.txt file can be overridden, making this option obsolete.
308 ALLOW_ROBOTS=null
309
310 # Allow server-side fetches to be performed to potentially unknown
311 # and user-provided locations. Primarily used in exports when loading
312 # in externally referenced assets.
313 # Can be 'true' or 'false'.
314 ALLOW_UNTRUSTED_SERVER_FETCHING=false
315
316 # A list of hosts that BookStack can be iframed within.
317 # Space separated if multiple. BookStack host domain is auto-inferred.
318 # For Example: ALLOWED_IFRAME_HOSTS="https://example.com https://a.example.com"
319 # Setting this option will also auto-adjust cookies to be SameSite=None.
320 ALLOWED_IFRAME_HOSTS=null
321
322 # The default and maximum item-counts for listing API requests.
323 API_DEFAULT_ITEM_COUNT=100
324 API_MAX_ITEM_COUNT=500
325
326 # The number of API requests that can be made per minute by a single user.
327 API_REQUESTS_PER_MIN=180
328
329 # Enable the logging of failed email+password logins with the given message.
330 # The default log channel below uses the php 'error_log' function which commonly
331 # results in messages being output to the webserver error logs.
332 # The message can contain a %u parameter which will be replaced with the login
333 # user identifier (Username or email).
334 LOG_FAILED_LOGIN_MESSAGE=false
335 LOG_FAILED_LOGIN_CHANNEL=errorlog_plain_webserver
Morty Proxy This is a proxified and sanitized view of the page, visit original site.