The EdgeX UI is for demonstration and developer use to manage and monitor a single instance of EdgeX Foundry (insecure or secure). Specifically, it can:
- Manage (add, remove, update) the EdgeX objects (device, device services, profiles, rules, app services, etc.)
- Monitor the EdgeX data flow (events and readings) and services
- Monitor and manage from on-box with EdgeX (on the same host)
As is, the EdgeX UI is not meant for production use! Developers can use the UI as a base from which to create additional user interfaces. The EdgeX community is also exploring production level use cases and extending/expanding the UI for future releases that would include more production level needs such as the ability to use the UI from on or off box.
Go implementation of EdgeX Web UI.
- Make sure you're using at least Go 1.12 (UI backend server currently uses Go 1.18.x)
- If your code is in your GOPATH then make sure
GO111MODULE=on
is set
git clone https://github.com/edgexfoundry/edgex-ui-go.git
cd edgex-ui-go
make build
To start the application and the web-based UI:
export EDGEX_SECURITY_SECRET_STORE=false
make run
To rebuild after making changes to source:
make clean
make build
To test the web-based UI:
make test
With a modern browser, navigate to https://yourdomain:4000 (change yourdomain to your server's hostname or ip).
NOTE: the GUI is running in non-secure mode when the environment variable EDGEX_SECURITY_SECRET_STORE=false, if EDGEX_SECURITY_SECRET_STORE=true, the accesss token for edgex is required, see the edgex document how to get the token.
NOTE: make sure that EdgeXFoundry is already running, Please refer to Edgex Services Get Started.
make docker
-
If you want to learn how to use the UI, you can refer to the user guide user guide.
-
If you find a bug or want to request a new feature, please open a GitHub Issue.