---
title: 'Running The Server'
url: 'https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/running-the-server'
markdown: 'https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/running-the-server.md'
date: '2026-09-25'
description: 'The Vaandroid runtime container allows Vaandroid plugins to be easily deployed on any machine. Steps'
taxonomy:
  category:
    - docs
---

[](#)  [ Home ](https://www.twelvetone.tv/docs/)     [ Operating Systems ](https://www.twelvetone.tv/docs/operating-systems)     [ Vaandroid ](https://www.twelvetone.tv/docs/operating-systems/vaandroid)     [ Vaandroid Developer Guide ](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide)     [ Tutorials ](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials)      Running The Server    

# Running The Server

The Vaandroid runtime container allows Vaandroid plugins to be easily deployed on any machine.

# Steps

- Downlaod and Unzip Vaandroid Server
- Open the terminal and cd into the ''Vaandroid Server'' directory
- Make the start command executable

    ```
    chmod +x start
    ```
- Start the runtime by clicking on the ''start'' script
- You can now go to <http://localhost:8181> in your web browser.
    The system will be waiting for a login provider and a branding provider.
- Add the ''allow-all login provider'' and ''branding provider'' to the apache-karaf/deploy directory.
    This provider will accept any username/password combination and log the user in as guest.
- Login You will see the Vaandroid Launcher, but no launchable activities have been installed.
- Install The HelloWorld Plugin Move the HelloWorld plugin into the deploy directory. After a few seconds, the activity will be displayed.

To stop ''Vaandroid Server'', type ''halt'' into the terminal.

```
> halt
```

 [ ](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/starting-karaf) [](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/creating-an-osgi-bundle)

---

## Navigation

- Parent: [Tutorials](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials.md)
- Previous: [Starting Karaf](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/starting-karaf.md)
- Next: [Using Gradle to create OSGi bundles with DS annotations](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/creating-an-osgi-bundle.md)