Docker installation

Prepare an environment with Docker. Refer to the Docker's Orientation and setup guide for more information.
Content in curly brackets { } signifies a placeholder. Both the curly brackets and the content within must be replaced for the request to work.
Run syntax
File mount for server-config.json
docker container run -d \ 
    --name {container-name} \
    -p {port-on-host}:{value-of-port-in-server-config.json}|{default-is-8080} \
    -v /mount/path/for/server-config.json:/usr/local/nxdb/server-config.json \
    -v NX-DATA:value-of-data-in-server-config.json-or-default-is-/var/nxdb ninoxdatabase/ninox-on-premise
Directory mount for the configuration folder containing server-config.json
docker container run -d \ 
    --name {container-name} \
    -p {port-on-host}:{value-of-port-in-server-config.json}|{default-is-8080} \
    -v /mount/path/for/config/:/usr/local/nxdb/config \
    -v NX-DATA:value-of-data-in-server-config.json-or-default-is-/var/nxdb ninoxdatabase/ninox-on-premise
Example run commands
Without a proxy between client and server and without specifying any server configuration
docker container run -d \
    --name nxdb \
    -v NX-DATA:/var/nxdb \
    -p 80:8080 ninoxdatabase/ninox-on-premise
Any changes applied to the server configuration using UMS interface are not persistent. Access Ninox via http://localhost. 
With a proxy between client and server
docker container run -d \
    --name nxdb \
    -p 6999:8080 ninoxdatabase/ninox-on-premise \
    -v NX-DATA:/var/nxdb \
    -v /mount/path/for/server-config.json:/usr/local/nxdb/server-config.json ninoxdatabase/ninox-on-premise
Specify the server configuration mount as it will override the default configuration. Access Ninox via http://{host-specified-in-server-config-json}.
Ensure the following criteria are met:
host
main parameter to be overridden
has a value with with the proxy is configured
HostPortin the-pdirective of the container
runcommand specifies the port on which the proxy will forward the incoming requests
SSL configuration
Without a proxy between client and server
We recommend configuring SSL on the Ninox server. Refer to the ssl property in theserver-config.json reference and populate the applicable properties within it. You can mount an additional directory within the container path,  for example with/usr/local/nxdb/certificates, and use it to populate the ssl field in server-config.json.
Ensure the following criteria are met:
redirectPortproperty changed to80to redirect all HTTP requests to an SSL enabled port
portproperty has a value of443
bindPortproperty has any value, for example8443, if available
With a proxy in between client and server
SSL should be configured on proxy itself.
Configuration file
server-config.json defines environment specific content that Ninox server will utilize to boot up. The configuration file is read from /usr/local/nxdb/server-config.json when the container boots up.
It is not mandatory to provide server-config.json at container runtime as a defaultserver-config.jsonis supplied with the image. However, ifserver-config.jsonneeds to overridden, supply a file mount using-v /mount/path/for/server-config.json:/usr/local/nxdb/server-config.jsoncommand line parameter.
For more information regarding server-config.json, refer to section Sample configuration file.

Last modified 1yr ago