github.com/iron-io/functions@v0.0.0-20180820112432-d59d7d1c40b2/docs/operating/options.md (about)

     1  # IronFunctions Runtime Options
     2  
     3  ## Configuration
     4  
     5  When starting IronFunctions, you can pass in the following configuration variables as environment variables. Use `-e VAR_NAME=VALUE` in
     6  docker run.  For example:
     7  
     8  ```sh
     9  docker run -e VAR_NAME=VALUE ...
    10  ```
    11  
    12  | Env Variables | Description | Default values |
    13  | --------------|-------------|----------------|
    14  | DB_URL | The database URL to use in URL format. See [Databases](databases/README.md) for more information. | bolt:///app/data/bolt.db |
    15  | MQ_URL | The message queue to use in URL format. See [Message Queues](mqs/README.md) for more information. | bolt:///app/data/worker_mq.db |
    16  | API_URL | The primary IronFunctions API URL to that this instance will talk to. In a production environment, this would be your load balancer URL. | N/A |
    17  | PORT | Sets the port to run on | 8080 |
    18  | LOG_LEVEL | Set to DEBUG to enable debugging | INFO |
    19  | DOCKER_HOST | Docker remote API URL | /var/run/docker.sock:/var/run/docker.sock |
    20  | DOCKER_API_VERSION | Docker remote API version | 1.24 |
    21  | DOCKER_TLS_VERIFY | Set this option to enable/disable Docker remote API over TLS/SSL. | 0 |
    22  | DOCKER_CERT_PATH | Set this option to specify where CA cert placeholder | ~/.docker/cert.pem |
    23  
    24  ## Starting without Docker in Docker
    25  
    26  The default way to run IronFunctions, as it is in the Quickstart guide, is to use docker-in-docker (dind). There are
    27  a couple reasons why we did it this way:
    28  
    29  * It's clean. Once the container exits, there is nothing left behind including all the function images.
    30  * You can set resource restrictions for the entire IronFunctions instance. For instance, you can set `--memory` on
    31  the docker run command to set the max memory for the IronFunctions instance AND all of the functions it's running.
    32  
    33  There are some reasons you may not want to use dind, such as using the image cache during testing or you're running
    34  [Windows](windows.md).
    35  
    36  ### Mount the Host Docker
    37  
    38  One way is to mount the host Docker. Everything is essentially the same except you add a `-v` flag:
    39  
    40  ```sh
    41  docker run --rm --name functions -it -v /var/run/docker.sock:/var/run/docker.sock -v $PWD/data:/app/data -p 8080:8080 iron/functions
    42  ```
    43  
    44  ### Run outside Docker
    45  
    46  You can of course just run the binary directly, you'll just have to change how you set the environment variables above.
    47  
    48  See [contributing doc](../CONTRIBUTING.md) for information on how to build and run.
    49