Logging in to the SUI requires a running instance of ManageIQ. Instructions on how to install ManageIQ can be found here.
- Have the ManageIQ repo cloned into a
directory named
manageiq
, and ready to be started. See here for the steps required to setup ManageIQ. - Have the SUI repo at the same level as
manageiq/
, this ensures the SUI builds,yarn build
, into the correct manageiq folder.git clone git@github.com:ManageIQ/manageiq-ui-service.git
- Have nodejs v18.x and npm 8.6.x installed (npm should be installed with NodeJS)
- If using nvm you can ensure you are using the correct node version with
nvm use
- Have yarn (^v1.0.1) globally installed.
npm install -g yarn
cd manageiq-ui-service
yarn
- From the
manageiq-ui-service
directory, build the production version of the SUI. This task will compile the assets and drop them into themanageiq/public/ui/service
directory.yarn build
- If you already have
manageiq
core running on port:3000
you can verify that the build worked correctly by visiting: http://localhost:3000/ui/service/#
-
From the
manageiq
directory, start the ManageIQ application to initiate the server listening on http://localhost:3000 . -
From the
manageiq-ui-service
directory, start the development version of the service UI, which will initiate the UI listening on http://localhost:3001, and talking to the REST API at http://[::1]:3000. This command will also open a browser page to http://localhost:3001/#.yarn start
-
To use a remote database prepend the
yarn start
command as follows, where the PROXY_PROTOCOL is the asset protocol, if left empty defaults tohttp://
, and PROXY_HOST is the IP address of the asset.PROXY_PROTOCOL=https:// PROXY_HOST=0.0.0.0 yarn start