Getting Started

Run the Sling Application

There are different ways to get Apache Sling running. You can either use Docker, download a distribution or build it from source.

Sling Docker Image

The preferred way to get Apache Sling running is to use Docker. If you don't have Docker installed you can skip to the next section.

We maintain a docker image of our latest release at Apache Sling Docker Image.

The simplest command to launch Sling is:

docker run -p 8080:8080 -v /tmp/sling:/opt/sling/sling apache/sling:12

This will start the latest released version of Apache Sling distribution and mount the Sling directory to /tmp/sling on your machine. Make sure that your docker configuration allows this or change to a different directory.

Sling Features

Another option is to download the latest released Apache Sling standalone feature archive and the Sling Feature Launcher from our Downloads section. Once you have downloaded them, unzip the Feature Launcher Archive and ensure that you have Java 8 or later installed.

Launch Sling with

./org.apache.sling.feature.launcher-*/bin/launcher -f org.apache.sling.starter-12-oak_*_far.far

Starting the Sling application creates the Sling directory name launcher in the same directory from where you started the above command.

Sling Karaf

You can run Sling on Karaf as well by either starting a Sling Karaf Distribution or installing Sling's Karaf Features into a running Karaf Container.

Explore Sling

Once Sling is started, you can access Sling at http://localhost:8080.

The Sling directory contains a directory logs. This directory contains all the log files created by Sling. The main log file is called error.log.

Where to head from here

We're on the way to update the documentation to make it more easy to get in touch with Sling. We recommend you read through following topics to get as fast as possible into Sling:

- ( Getting Started )