Skip to content

Environment Variables

Grey Christoforo edited this page Mar 28, 2016 · 4 revisions

There are a few environment variables that I use in the container to manage various things. I'll list them here with their defaults and a description of what they do. To override them, use -e VARIABLE_NAME=NEW_VALUE in your docker run command when you start the container.

START_APACHE=true
If you change this, Apache won't start up when the container is run and it will be essentially useless.

START_MYSQL=true
If you change this, mariadb (the MySQL server built into the container) won't start up when the container is run. If you're super concerned about wasting a small amount of computing resources and you haven't explicitly configured ownCloud to use the MySQL server built into this image, then you should set this to false

REGENERATE_SSL_CERT=false
Whenever the container is started when this is set to true, a new self-signed SSL certificate will be re-generated using the details in the SUBJECT variable (see below for details). That way you can be sure nobody can snoop on your https traffic. You obviously don't want to change this if you're providing your own certificate files (See the README.md on how to do that).

SUBJECT=/C=US/ST=CA/L=CITY/O=ORGANIZATION/OU=UNIT/CN=localhost
These are the details used whenever the SSL certificate is re-generated. CN=localhost is especially important to change if you wish to use https to access your server using any hostname or IP other than localhost.

TARGET_SUBDIR=owncloud
Set URL path where to access ownCloud. Default makes it available at http://localhost/owncloud. Set to a single slash if you want to access owncloud at the root level aka http://localhost/.

ALLOW_INSECURE=false
When this is false, attempting to visit your owncloud server page without https will give a 503 error: "Please use https."