Fabric8 Documentation

Getting Started

This distro is still experimental

This distro is still experimental

If you've used a previous version, you may want to check out the Change Log

Installation

Unpack the tarball:

cd ~/Downloads
unzip fabric8-karaf-1.2.0.Beta4.zip
cd fabric8-karaf-1.2.0.Beta4


Or, build the project with Maven via:

MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=512m"
mvn -DskipTests clean install -Pall
cd fabric/fabric8-karaf/target
unzip fabric8-karaf-1.2.0-SNAPSHOT.zip
cd fabric8-karaf-1.2.0-SNAPSHOT


Create a fabric

By default, fabric starts up with a default admin user with username admin and password admin. This can be changed by editing the etc/users.properties file before starting fabric for the first time.

Now to create a fabric using the karaf distribution type:

bin/fabric8


If you are using the Tomcat or TomEE distribution type:

bin/fabric8 run


Once the container has started up, you have a working Fabric and you can connect to the console.

Use the web console

Then open the hawtio based console via the Karaf web console, which runs on port 8181:

http://localhost:8181/


Then check out the documentation in the embedded fabric8 wiki to guide you through all the available profiles you can create in a new container or add to an existing container.

Or check out:

Web console for Tomcat or TomEE distributions

If you are using the Tomcat or TomEE distribution, then the console is on port 8080, and the console is deployed under the hawtio context path. The url for the web console is therefore:

http://localhost:8080/hawtio/


View a demo

To help you get started, you could watch one of the demos in the

For example, try the

Try QuickStarts

New users to Fabric8 should try the QuickStarts.