Advanced Configuration

Use Custom Port

If you need to expose the main application on other port than default 3000, you have to:

• update port mapping -p <custom-port>:3000 parameter
• provide environment variable -e EXTERNAL_PORT=<custom-port>

So the example command for port 3333 looks like this:

docker run -i -t -e EXTERNAL_PORT=3333 -p 3333:3000 -p 5432:5432 \
  --name gooddata-demo --rm gooddata/gooddata-cn-ce:1.0.1

docker run -i -t -e EXTERNAL_PORT=3333 -p 3333:3000 -p 5432:5432 `
  --name gooddata-demo --rm gooddata/gooddata-cn-ce:1.0.1

Logging Verbosity Setup

Two environment variables can be passed on docker command line to change level of log verbosity.

• APP_LOGLEVEL - defines logging level for GoodData.CN components.
• PULSAR_LOGLEVEL - defines logging level for Apache Pulsar. Both these variables can contain one of ERROR, WARN, INFO, DEBUG or TRACE. Default it WARN.

Example of running AIO container with increased application logging verbosity:

docker run -i -t -p 3000:3000 -p 5432:5432 --name gooddata-demo --rm \
  -e APP_LOGLEVEL=INFO gooddata/gooddata-cn-ce:1.0.1

docker run -i -t -p 3000:3000 -p 5432:5432 --name gooddata-demo --rm `
  -e APP_LOGLEVEL=INFO gooddata/gooddata-cn-ce:1.0.1

Persistent Data

You can attach docker volume when starting container. All data that need to be preserved are kept in /data directory of the container. This option will allow you to preserve data when you delete container, so it may be helpful for version upgrades. To run docker container with attached volume, use -v gd-volume:/data option on command line:

docker run -i -t -p 3000:3000 -p 5432:5432 -v gd-volume:/data \
  --name gooddata-demo --rm gooddata/gooddata-cn-ce:1.0.1

docker run -i -t -p 3000:3000 -p 5432:5432 -v gd-volume:/data `
  --name gooddata-demo --rm gooddata/gooddata-cn-ce:1.0.1

Note that upgrading docker image is possible only for minor and patch version releases. It is not supported for major version upgrades.

Data volume can be later removed using docker volume rm gd-volume command.