Import your own code

Configuring projects

In the previous step, you created a new project on using the CLI. Now, there are a few configuration steps left that will help know what to do with your application during builds and deployments.

  1. Consult a template alongside this guide

    As you go through this guide, example files will be provided that will give you a good impression of how to configure applications on in the programming language they use. However, since they are simple examples and your own application may require more detailed configuration than those examples address, it is recommended that you take a look at our maintained templates for additional guidance.

    Select a language and choose one or more templates that most closely resemble your application and keep the template in another tab as you continue through this guide. Using these two resources together is the fastest way to correctly configure your project for

  2. Create empty configuration files

    You will notice that each of the templates above contain the following structure around their application code:

     ├── .platform
     │   ├── routes.yaml
     │   └── services.yaml
     └── < application code >

    In order to successfully deploy to you must add three YAML files:

    • A .platform/routes.yaml file, which configures the routes used in your environments. That is, it describes how an incoming HTTP request is going to be processed by
    • A .platform/services.yaml file, which configures the services that will be used by the application. Connecting to's maintained services only requires properly writing this file. While this file must be present, if your application does not require services it can remain empty.
    • At least one file, which configures the application itself. It provides control over the way the application will be built and deployed on

      When you set as a remote for your repository in the previous step, the CLI automatically created the hidden configuration directory .platform for you. The next steps will explore in more detail what each configuration files must include, but for now create empty files in their place.

      touch .platform/routes.yaml
      touch .platform/services.yaml
  3. (Optional) Follow the Project Setup Wizard instructions in the management console

    All of the steps in this guide are also available in the Project Setup Wizard in your management console. Once you have created your project, the Wizard will appear at the top of your project page with detailed steps to help you properly configure your applications on

    Project Setup Wizard

With the empty configuration files in place, you will need to specify your service configuration in .platform/services.yaml.