---
title: 'Cloud Server Tutorial'
url: 'https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/cloud-server-tutorial'
markdown: 'https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/cloud-server-tutorial.md'
date: '2026-09-25'
description: 'The Vaandroid Cloud Server is an application that provides the Vaandroid Runtime as a web site to web browsers. The V'
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)      Cloud Server Tutorial    

# Cloud Server Tutorial

The Vaandroid Cloud Server is an application that provides the Vaandroid Runtime as a web site to web browsers.

> The Vaandroid Cloud Server is built on Karaf, that is built on OSGi, that is built on Java.
> 
> The Vaandroid Cloud Server is also built on Vaadin, that is built on GWT, that is built on Javascript and Java.

# Download

You can download the Vaandroid Cloud Server from [here](http://downloads.twelvetone.tv).

# Install

Unzip the server. You may need to enable the executable bit of the *start* script

```bash
cd 'vaandroid cloud server'
chmod +x start
```

## Running As A Service

If you want to run as a service, view articles specific to your operating system. Running as a service will start the server automatically and without the need to log in as a user.

# Launch

Launch the *start* script.

```bash
./start
```

![](https://www.twelvetone.tv/docs/user/pages/02.operating-systems/03.vaandroid/03.vaandroid-developer-guide/15.tutorials/12.cloud-server-tutorial/cloud-console.png)

# Open The Site

Navigate to <https://localhost:8444>.

![](https://www.twelvetone.tv/docs/user/pages/02.operating-systems/03.vaandroid/03.vaandroid-developer-guide/15.tutorials/12.cloud-server-tutorial/login.png)

Login as Guest

![](https://www.twelvetone.tv/docs/user/pages/02.operating-systems/03.vaandroid/03.vaandroid-developer-guide/15.tutorials/12.cloud-server-tutorial/home.png)

# Install Plugins

## Hello World

Here's a [Hello World plugin](http://downloads.twelvetone.tv/vaandroid/plugins/hello-world.jar). Put it in the karaf/deploy directory. This is the exact same activity found in the Android Studio sample.

![](https://www.twelvetone.tv/docs/user/pages/02.operating-systems/03.vaandroid/03.vaandroid-developer-guide/15.tutorials/12.cloud-server-tutorial/hello-activity.png)

## Charts

The Charts API provides a chart viewer application, and a simple API for plugins to contribute chart data to the system.

You will need to add 3 plugins to Vaandroid:

charts.apiThe public Charts API.chartsThe chart viewer activity.charts.samplesA plugin that provides the system with sample chart data.After placing the 3 plugins into the deploy directory, launch the Chart Viewer Activity.

![](https://www.twelvetone.tv/docs/user/pages/02.operating-systems/03.vaandroid/03.vaandroid-developer-guide/15.tutorials/12.cloud-server-tutorial/chart-viewer-2.png)

![](https://www.twelvetone.tv/docs/user/pages/02.operating-systems/03.vaandroid/03.vaandroid-developer-guide/15.tutorials/12.cloud-server-tutorial/chart-viewer-1.png)

To demonstrate the power of the Vaandroid Runtime, remove the chart sample plugin while the Chart Activity running. After a few moments, the sample charts will *vanish*. Then put the plugin back in. They will *reappear*. Neat!

# Shutdown

To shutdown the server, type *logout* in the Karaf console.

```bash
karaf@root()> logout
```

This will terminate the server and disconnect all web clients.

> You can also type *system:shutdown*, *halt*, or even press *control-d*.

 [ ](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/basic-vaandroid-tutorial) [](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/sample-source-code)

---

## Navigation

- Parent: [Tutorials](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials.md)
- Previous: [Basic Vaandroid Tutorial](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/basic-vaandroid-tutorial.md)
- Next: [Sample Source Code](https://www.twelvetone.tv/docs/operating-systems/vaandroid/vaandroid-developer-guide/tutorials/sample-source-code.md)