OVERVIEW
This document contains a concise all-purpose reference.
ENVIRONMENT VARIABLES
Many parts of Mojolicious can be tuned with environment variables.
Debug environment variables are excluded because they are for developer use
only.
MOJO_APP
Decides which Mojolicious or Mojo application will be used, should
always contain a class name like
"MyApp", usually defaults to
Mojo::HelloWorld.
MOJO_APP=MyApp
MOJO_CA_FILE
The path to the
TLS CA authority file, should always contain a path like
"/etc/tls/cacerts.pem".
Note that IO::Socket::SSL must be installed for
TLS support.
MOJO_CA_FILE=/etc/tls/cacerts.pem
MOJO_CHUNK_SIZE
Chunk size used for
IO operations in bytes, a bigger chunk size speeds up
IO
operations but will also use more memory.
MOJO_CHUNK_SIZE=1024
MOJO_EPOLL
Force epoll mainloop for
IO operations.
Note that IO::Epoll must be installed for epoll support.
MOJO_EPOLL=1
MOJO_HOME
Home directory for the Mojolicious application, should always contain a
path like
"/home/sri/myapp".
MOJO_HOME=/home/sri/myapp
MOJO_KQUEUE
Force kqueue mainloop for
IO operations.
Note that IO::KQueue must be installed for kqueue support.
MOJO_KQUEUE=1
MOJO_LOG_LEVEL
Log level for the Mojolicious application, should contain a valid log
level like
"debug" or
"error".
MOJO_LOG_LEVEL=debug
MOJO_LOG_LEVEL=error
MOJO_MAX_LINE_SIZE
Maximum line size for
HTTP message start lines and headers in bytes, defaults
to
10240.
MOJO_MAX_LINE_SIZE=2048
MOJO_MAX_MEMORY_SIZE
Maximum size in bytes for
HTTP content to keep in memory, bigger content will
be written to temporary files, defaults to
24576.
MOJO_MAX_MEMORY_SIZE=2048
MOJO_MAX_MESSAGE_SIZE
Maximum size for
HTTP messages in bytes, defaults to
524288.
MOJO_MAX_MESSAGE_SIZE=1024
MOJO_MODE
Run mode for the Mojolicious application, should contain a valid mode like
"development" or
"production".
MOJO_MODE=development
MOJO_MODE=production
MOJO_NO_IPV6
Disable IPv6 support, this might result in slightly better performance and
less memory use.
Note that IO::Socket::INET6 must be installed for IPv6 support.
MOJO_NO_IPV6=1
MOJO_NO_TLS
Disable
TLS support, this might result in slightly better performance and
less memory use.
Note that IO::Socket::SSL must be installed for
TLS support.
MOJO_NO_TLS=1
MOJO_POLL
Force poll mainloop for
IO operations, this should only be used for testing
since other mainloops are generally faster and scale better.
MOJO_POLL=1
MOJO_RELOAD
Enable Mojolicious application reloading, changes to your application will
be detected automatically so you don't have to restart the server manually.
MOJO_RELOAD=1
MOJO_REVERSE_PROXY
Enable reverse proxy support for Mojolicious application.
MOJO_REVERSE_PROXY=1
MOJO_TEMPLATE_CLASS
Class the Mojolicious renderer should use to find
"DATA" templates,
defaults to
"main".
MOJO_TEMPLATE_CLASS=MyApp
MOJO_TMPDIR
Directory for temporary files like huge uploads, by default a random platform
specific temporary directory will be used.
MOJO_TMPDIR=/tmp/mojo