Nimbella Lite
Nimbella Lite
by Nimbella Corp.

Version Latest

OS Ubuntu 18.04

Create Nimbella Lite Droplet


Nimbella Lite provides you with a platform for building serverless applications, not just functions. It is Powered by Apache OpenWhisk, an industry-strength platform for serverless computing that can handle enterprise-level scaling. This one-click deployment comes bundled with the Nimbella Serverless Workbench which complements your day-to-day development and provides a uniform experience for building serverless applications, from your desktop to the cloud. Connect with us via to get early updates to the Workbench.

Software Included

Getting started after deploying Nimbella Lite

Once your droplet is live, visit for an introduction to the Nimbella Serverless Workbench, and a brief guide to creating serverless functions with Apache OpenWhisk.

The Playground

The Workbench playground is the easiest way to create and run your first serverless functions. The playground requires no authentication to use and allows you to expose limited functions as API endpoints. Type playground on the Workbench prompt to get started.

You can collapse the playground using your ESC key. This will expose the workbench help menu. Type help at any time to get additional guidance.

Creating and invoking functions

If you're familiar with OpenWhisk, you can proceed to use the OpenWhisk command line tool wsk directly in your browser.

Some commands to try:

# list available utility functions
> wsk action list /whisk.system/utils

# invoke a function
> wsk action invoke /whisk.system/utils/date

# see activations
> wsk activation list

# another way to see activations
> grid

# list other available packages
> wsk package list /whisk.system

Getting an API key

You will need to generate API keys to use wsk from the command line or via the Workbench. The OpenWhisk management tools located in /home/openwhisk/bin make this easy. Here is an example to create a key for a new username:

su -c '$HOME/openwhisk/bin/wskadmin user create <username>' openwhisk

In the Workbench, you add a new authentication key like this:

auth add <authentication-key>

Login to your Droplet via SSH for to retrieve a guest key and learn how to configure the wsk CLI.

Automatic hostname with SSL

The OpenWhisk API host in your droplet can be accessed by its Droplet_IP, or as a subdomain, replacing 1-2-3-4 with your droplet's IP address. Notice that - is used instead of . to refer to your droplet when referenced in this way. The message-of-the-day which is printed to the console when you ssh to the droplet will show you the hostname specific to your droplet.

The subdomain is configured with a Let's Encrypt SSL certificate that allows you to conveniently access your droplet with a valid certificate. You should replace the certificate with your own and attach your own domain name before the certificate expires. The bundled certificate will not renew in your droplet.

Additionally, every user of the OpenWhisk deployment in your droplet gets their own hostname, which allows one to properly use cookies and browser local storage with their serverless functions. A username guest can access its own hostname by prefixing the username to the domain, as in

See OpenWhisk's documentation on vanity domains for more information.

Notes about deployment configuration

The droplet is configured in a way that is suitable for small, single-droplet deployments. Functions that you create are stored in CouchDB inside your droplet and will persist across reboots.

The port to access CouchDB from the internet is blocked. If you expose CouchDB to the internet, you must change the admin password and redeploy the system.

More information about Apache OpenWhisk is available on the project website at Apache OpenWhisk and OpenWhisk, are either registered trademarks or trademarks of The Apache Software Foundation in the United States and other countries. All other marks mentioned may be trademarks or registered trademarks of their respective owners.

To learn more about Nimbella, visit or connect with us via

API Creation

In addition to creating a Droplet from the Nimbella Lite 1-Click App via the control panel, you can also use the DigitalOcean API.

As an example, to create a 4GB Nimbella Lite Droplet in the SFO2 region, you can use the following curl command. You’ll need to either save your API access token to an environment variable or substitute it into the command below.

  curl -X POST -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer '$TOKEN'' -d \
      '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"nimbella-18-04"}' \

Support Details

Support URL:

More DigitalOcean Links

DigitalOcean Community

Developers supporting developers

Ask a Question

Ask anything related to system administration, programming, devops, open source, or the DigitalOcean platform.

List your 1-Click App in the DigitalOcean Marketplace

Partner with us to build traction for your open source project or software company