We removed our free Sandbox April 25th.
You can read more on our blog.

In-Depth Example

Quick Start Guide


This guide assumes you have already signed up and installed the CLI. This example will require approximately 10 minutes to complete.

A Simple Example

Now that you have the DotCloud CLI installed, let’s go ahead and deploy our first application. In this example, we will be deploying a very simple application that serves a static “Hello World” file.

Create a new folder and change to that folder:

$ mkdir helloworldapp
$ cd helloworldapp

Fire up your favorite text editor, write a message to yourself and save it as index.html:

    <title>Hello World!</title>
    Hello World!

Then create your application on the “flavor” of your choice, flavors corresponds to different runtime (clusters) with different features and pricing. In this example, we’ll name the application “helloworldapp” and use the default flavor, Sandbox, which is free:

$ dotcloud create helloworldapp
Created application "helloworldapp" using the flavor "sandbox" (Use for development, free and unlimited apps. DO NOT use for production.)

Next, we’ll create a DotCloud build file that describes an application with a single static service. The static service is a simple web server that can be used to host static files such as HTML and images. Create a file named dotcloud.yml with the following text:

  type: static

Your application is ready with a static service. Now you can push your current directory with your index.html file and your DotCloud Build File.

$ dotcloud push helloworldapp


You have just deployed your first DotCloud application.

We chose to deploy a very simple static site in this example, but you’ll find that it’s just as easy to deploy any kind of application. See the full list of services available under the Services section in the navigation bar on the left. You can mix and match various services, such as a PHP service for your PHP application, and a MySQL service for the database.

Continue with the tutorials to learn how to deploy a more advanced, database-backed application.

In-Depth Example