Quick Start Guide

Prerequisites

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. Fire up your favorite text editor, and write a message to yourself and save it as index.html:

<html>
  <head>
    <title>Hello World!</title>
  </head>
  <body>
    Hello World!
  </body>
</html>

Then create a namespace for your application. In this example, we’ll name the application “helloworldapp”.

$ dotcloud create helloworldapp
Created application "helloworldapp"

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:

www:
  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
...

Congratulations!

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