With Docker

Run #

Dev profile #

Start universalid in a Docker container:

docker run -t --net=host $IMAGE_NAME dev
  • -t attaches a pseudo-TTY to the container, connecting your terminal to the I/O streams of the container.
  • --net=host uses host network. Alternatively, you can pass each port mapping individually. Example -p 8080:8080
  • dev loads the zero config universalid profile for development.

Dev profile starts with DEBUG logging enabled, listens to http port: 8080, connects to a Postgres database at the default port 5432 with default name and credentials. It will also load the SCIM core User schema urn:ietf:params:scim:schemas:core:2.0:User along with two extensions, urn:se:universalid:extension:Device and urn:se:universalid:extension:Computer.

Custom profile #

You can start universalid with a custom profile. Mount the path of your config and crypto directories. The first must contain the application.yaml configuration file. The latter must contain the server keystore/truststore for HTTPS and mTLS.

docker run -t --net=host \
  --mount type=bind,src=/path/to/universalid/config,dst=/deployments/config \
  --mount type=bind,src=/path/to/universalid/crypto,dst=/deployments/crypto $IMAGE_NAME custom