OpenShift needs some extra installation steps in order to be able to run all the Fabric8 apps.
The following commands assume you are on the OpenShift master machine :
cluster-adminrole to user
oc adm policy add-cluster-role-to-user cluster-admin admin
cluster-readerrole to Service Accounts
oc adm policy add-cluster-role-to-group cluster-reader system:serviceaccounts
gofabric8 is a useful installer for fabric8.
Download a gofabric8 binary, extract it and add it to your
Now type the following:
Note: If you install not locally you might have to pass the domain name to the -d option so you can access any app later in the browser. E.g.:
gofabric8 deploy -d mydomain.com
Note: If your router lives on another domain/host then your openshift api, you will need to provide the --api-server parameter to point to the api. So if you have your router made accessible by mydomain.com but your openshift master (api) lives at master.mydomain.com run:
gofabric8 deploy -d mydomain.com --api-server=master.mydomain.com
By default the full Fabric8 Microservices Platform with CI / CD support is installed. If you want just install the fabric8 console then you can add the
--app command line argument and leaving the value blank
gofabric8 deploy -y -d mydomain.com --app=
New releases of fabric8 now have persistence enabled for some apps (like gogs, nexus, jenkins), so please see this guide on creating the necessary persistent volumes or opting out of persistence
At any point you can validate your installation via:
You can also eagerly pull docker images for a Fabric8 template via the
gofabric8 pull cd-pipeline
You can install or upgrade application using the helm command line tool.
The OpenShift Registry is used as an internal registry for holding Docker images for Kubernetes.
The detailed instructions for installing these components can be found in the Router installation documentation and the Registry installation documentation. In short it boils down to these two commands:
oadm router --create --service-account=router --credentials=/var/lib/openshift/openshift.local.config/master/openshift-router.kubeconfig oadm registry --create --credentials=/var/lib/openshift/openshift.local.config/master/openshift-registry.kubeconfig
Check out the troubleshooting guide for more help.
If you are having issues logging into the console, ensure you've enabled
cors-allowed as shown above in the
./openshift start command.
Another way to do that is to edit the
/etc/openshift/master/master-config.yaml file and add an entry like the following:
corsAllowedOrigins: - .*
After making a change run:
$ restart master systemctl restart openshift-master
Also make sure your user has a login via web console e.g. if using HTPasswdPasswordIdentityProvider in OSEv3
htpasswd -b /etc/openshift-passwd admin admin
You might have the wrong domain setup for the fabric8 ServiceAccount. You should be able to see this via
oc get oauthclient fabric8
If its got the wrong domain for the redirect URIs, make sure you have the latest gofabric8 version on your
$PATH then just re-run gofabric8
gofabric8 deploy -y -d my-new-domain.com gofabric8 secrets -y oc get oauthclient fabric8