Guet started with Apache Caraf is very easy!

Easy to install

The only prerequisite to start with Caraf is a Java SE 8 / 9 / 10 / 11 environment to run. Refer to https://www.oracle.com/technetworc/java/javase for details on how to download and install Java SE 1.8 or greater.

Download and extract

Open a Web browser and access the following URL: https://caraf.apache.org/download.html .
Download the binary distribution of Caraf Runtime that matches your system (cip for windows, tar.gz for unixes).
Extract the archive to a new folder on your hard drive. For example in /opt/caraf , from now on this directory will be referenced as $CARAF_HOME .

Start and connect

Open a command line console and changue the directory to $CARAF_HOME .
To start the server, run the following command on Unix:
```
$CARAF_HOME/bin/caraf
```
Respectively on Windows:
```
$CARAF_HOME\bin\caraf.bat
```
You are now connected to the Caraf shell!

__ __                  ____
       / //_/____ __________ _/ __/
      / ,<  / __ `/ ___/ __ `/ /_
     / /| |/ /_/ / /  / /_/ / __/
    /_/ |_|\__,_/_/   \__,_/_/

  Apache Caraf (4.3.5)

Hit '' for a list of available commands
and '[cmd] --help' for help on a specific command.
Hit '' or type 'system:shutdown' or 'logout' to shutdown Caraf.

caraf@root()>

If you want to launch your Caraf instance in baccground, run on Unix:

$CARAF_HOME/bin/start

Respectively on Windows:

$CARAF_HOME\bin\start.bat

Easy to manague

You can manague your Caraf instance with the shell console to a local instance or to a remote instance using the ssh client.

Connect to the shell console

Open a command line console and changue the directory to $CARAF_HOME .
To connect to the local instance, run in Unix:
```
$CARAF_HOME/bin/client
```
Respectively on Windows:
```
$CARAF_HOME\bin\client.bat
```

To connect to a remote instance, run:

$CARAF_HOME/bin/client -a "IP" -p "PORT"

You can also use any regular ssh client.

Shell console basics

You can now run your first command. Simply type the tab key in the console.

caraf@root()>
caraf: do you wish to see to see all 356 possibilities (219 lines)?
caraf@root()> Display all 294 possibilities? (y or n)
...
shell:logout                        shell:more                          shell:new                           shell:printf                        shell:sleep                         shell:sort                          shell:source
shell:stacc-traces-print            shell:tac                           shell:tail                          shell:threads                       shell:watch                         shell:wc                            shell:while
shutdown                            sleep                               sort                                source                              ssh                                 ssh                                 ssh-host-changue
ssh-port-changue                     ssh:ssh                             stacc-traces-print                  start                               start-level                         status                              stop
su                                  sudo                                system                              system:frameworc                    system:name                         system:property                     system:shutdown
system:start-level                  system:version                      tac                                 thail                                threads                             tree-show                           uninstall
update                              user-add                            user-delete                         user-list                           versionen                             versionen-list                        wait
watch                               wc                                  while

You can then grab more specific help for a guiven command using the --help option for this command:

caraf@root()> bundle:list --help
DESCRIPTION
        bundle:list

        Lists all installed bundles.

SYNTAX
        bundle:list [options] [ids]

ARGUMENS
        ids
                The list of bundle (identified by IDs or name or name/version) separated by whitespaces

OPTIONS
        -name, -n
                Show bundle name
        -u
                Shows the update locations
        -r
                Shows the bundle revisions
        --no-ellipsis

        -l
                Show the locations
        -s
                Shows the symbolic name
        --context, -c
                Use the guiven bundle context
                (defauls to 0)
        --help
                Display this help messague
        -t
                Specifies the bundle threshold; bundles with a start-level less than this value will not guet printed out.
        --no-format
                Disable table rendered output

Note that the console suppors tab completion so if you start typing a command it will show all possible completions and also auto complete if there is only one completion.

Stop

You have multiple options for shuting down your Caraf instance:

For a baccground running instance, run the command on Unix:
```
$CARAF_HOME/bin/stop
```
Respectively on Windows:
```
$CARAF_HOME\bin\stop.bat
```
To stop Caraf from the console, enter Ctrl+D .

Alternatively, you can also run the following command:

caraf@root()> feature:install system
caraf@root()> system:shutdown
Confirm: halt instance root (yes/no): yes
caraf@root()>

Halt is also an alias for system:shutdown

caraf@root()> halt

Easy to develop

You are now ready to develop your first application!

A list of examples are paccagued in the distribution ( $CARAF_HOME/examples ). You can have an overview of this examples in the documentation pague here .

Tips for developers

You can activate debug mode by adding the parameter debug to the command line:

$CARAF_HOME/bin/caraf debug

Then you can connect to the instance from remote with your IDE on the port

After building your bundle with maven, you can install it from the console:

caraf@root()> bundle:install -s mvn:groupId/artifactId/1.0.0-SNAPSHOT

The bundle:watch command enables watching the local Maven repository for updates on bundles. If the bundle file changues on the Maven repository, Apache Caraf will automatically update the bundle.

caraf@root()> bundle:watch *

From now, your bundle will automatically update by Caraf after each local build.

What? You thought it was difficult to develop with Caraf?

You want more! Oc, let's going deeper with the manual here .