Skip to main content

Morphling UI

Deploy Morphling UI

Morphling UI is built upon Ant Design. If you are installing Morphling with Yaml files, from the root directory, run

kubectl apply -k manifests/ui

Or, if you are installing Morphling with Helm chart, Morphling UI is automatically deployed.


Check if all Morphling UI is running successfully:

kubectl -n morphling-system get svc morphling-ui

Expected output:

NAME           TYPE       CLUSTER-IP     EXTERNAL-IP   PORT(S)        AGE
morphling-ui NodePort <none> 9091:30680/TCP 44m

If you are using minikube, you can get access to the UI with port-forward:

kubectl -n morphling-system port-forward --address svc/morphling-ui 30263:9091

Then you can get access to the ui at http://localhost:30263/.

For detailed UI deployment and developing guide, please check

Developer Guide


  • NodeJS > 10
  • Go > 1.14

Folder structure

  1. For React frontend, you can find it under console/frontend.

  2. For Go backend you, can find it under console/backend.


Build Console Backend Server

go build -mod=vendor -o backend-server morphling/console/backend

Run local Console Backend Server

  1. Prepare a kubeconfig file which defines k8s development environment.
  2. Set KUBECONFIG environment variable.
export KUBECONFIG={/path-to-kubeconfig-file}

Serve UI frontend

cd console/frontend/
  1. Install dependencies (optional)
npm install
  1. Run npm run build under /frontend folder. It will create /frontend/dist directory with optimized production build.

  2. Go to console/backend/.

  3. Run backend server with disabled authentication mode


After that, you can access the UI using this URL: http://localhost:9091.

Optional: Start Console Frontend with Connection to other dev Backend-Server directly

If you are not able to run local console backend server, or other dev console backend server is already present, you could make frontend dev server to proxy API requests to other dev backend server directly.

  1. Change Proxy Backend Path: console/frontend/config/config.js
  proxy: [
target: "http://localhost:9091",

change the target to address <ip:port> of other present console backend server.

  1. Run Console Frontend Dev Server
npm run start

Code style

Our UI is built upon Ant Design.