.. _server_conf:

Server configuration
--------------------

Enterprise Steam has a small configuration file for changes that cannot be made in the Web UI. You can find a template of the configuration file at **/opt/h2oai/steam/conf/steam.yaml.template**.

::

  # Directory that contains Steam data.
  STEAM_DATA_DIRECTORY: ./data

  # This port is the one to be exposed externally.
  # Steam's bundled haproxy binds to this port.
  # Steam starts and manages it's own haproxy process with it's own
  # config file (which is autogenerated).
  STEAM_HTTPS_PORT: 9555

  # Port used internally by jupyterhub
  # Port + 1 is also used by jupyterhub for end user access
  STEAM_JUPYTERHUB_PORT: 28080
  
  # Port used for configurable proxy api
  # Used to set up proxy for jupyterhub
  STEAM_PROXY_PORT: 8001
  
  # port for apache livy server
  STEAM_LIVY_PORT: 28998

  # The internal port for the Steam process.
  # This is the internal port of the Steam itself. It should never be
  # accessed directly. See STEAM_HTTPS_PORT for the public port to use
  # when accessing Steam. It is rare that this port should be set except
  # in cases of port conflict.
  STEAM_INTERNAL_PORT: 29000

  # By default, the steam admin is able to stop and remove instances of h2o and dai
  # that were created by users. This can be disabled for hadoop, kubernetes, or both 
  # by setting the following flags to 1
  DISABLE_STEAM_HADOOP_SUPER_ADMIN: 0
  DISABLE_STEAM_KUBERNETES_SUPER_ADMIN: 0  
  DISABLE_STEAM_SUPER_ADMIN: 0

  # By default, kubernetes hostPath volume mounts are allowed. This can be disabled
  # by setting the following flags to 1
  DISABLE_STEAM_KUBERNETES_HOST_PATH_MOUNT: 0

  # By default, uploading custom documentation files is allowed. This can be disabled
  # by setting the following flag to 1
  DISABLE_STEAM_DOCUMENTATION_UPLOAD: 0

To make any changes, save the modified configuration file as **/opt/h2oai/steam/conf/steam.yaml** and :ref:`restart` Enterprise Steam.

systemd configuration
~~~~~~~~~~~~~~~~~~~~~

RPM and DEB installations place the systemd configuration into **/etc/default/steam** and you may edit it there.

::

    #
    # Installation directory for Enterprise Steam.
    # Application will be invoked as '$STEAM_HOME/bin/steam serve $ARGS'.
    #

    STEAM_HOME=/opt/h2oai/steam

    #
    # Extra flags you might want to pass to Enterprise Steam.
    #

    ARGS=""

    #
    # User that runs the Enterprise Steam process.
    #

    USER="steam"