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-servicedirectory, build the production version of the SUI. This task will compile the assets and drop them into themanageiq/public/ui/servicedirectory.yarn build - If you already have
manageiqcore running on port:3000you can verify that the build worked correctly by visiting: http://localhost:3000/ui/service/login
-
From the
manageiqdirectory, start the ManageIQ application to initiate the server listening on http://localhost:3000 . -
From the
manageiq-ui-servicedirectory, 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/login.yarn start -
To use a remote database prepend the
yarn startcommand 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