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.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
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
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
. 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
HostPort
in the-p
directive of the containerrun
command specifies the port on which the proxy will forward the incoming requests
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:
redirectPort
property changed to80
to redirect all HTTP requests to an SSL enabled portport
property has a value of443
bindPort
property has any value, for example8443
, if available
SSL should be configured on proxy itself.
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.json
is supplied with the image. However, ifserver-config.json
needs to overridden, supply a file mount using-v /mount/path/for/server-config.json:/usr/local/nxdb/server-config.json
command line parameter.