Skip to content Deployment Deployment

Overview is a powerful hosting provider for your infrastructure that's quite easy to use.

Keep in mind, though, that this is not the only way to go for apps. You can, of course, use different services, providers or host everything on a dedicated machine. This guide explains to you how to get started for hosting an app on

Know more about hosting from the hosting guide and from the official documentation.

Getting started

To deploy your app on, just follow those instructions:

Most important steps

  1. Configure your Source Integrations (Optional, but highly recommended!)
  2. Install the CLI
  3. Authenticate using your account
  4. Create required config files. Also, if you create a new project, shows you a checklist where you can generate the code for these files
  5. Push your changes to your Git Repo
  6. After it's been deployed, migrate the database by connecting via SSH to your project and running the command vendor/bin/doctrine-migrations migrations:migrate
  7. That's it!

Your project should now be running at, and you can start developing your own app!

Good to know

Automatic TLS certificates based on Branch / Pull Request automatically creates a URL and TLS certificate using Let's Encrypt based on your routes.yaml file for every active environment.

You should be aware that the URL will be built in a specific way. If your branch name gets too long, Let's Encrypt won't be able to generate a certificate.

To avoid this, you should configure your Source Integrations to use the name of your Pull Request instead of the Branch Name.

Read more about this topic from

Hook commands

You can place commands like the database migration mentioned above inside your under hooks. This way your commands will be executed every time it deploys a new build (e.g. if your branch gets updated).

Your file could than look like this (with the default AppTemplate):

    build: |
        set -e
        php bin/console assets:install --no-debug
    deploy: |
        set -e
        php bin/console cache:clear
        php bin/console doctrine:migrations:migrate --no-interaction

By default, PHP images already run a composer install command, so we don't need that in our hooks. Learn more about that here.

Useful commands

In order to use the following commands you need to have the CLI installed.

List all CLI commands

platform list

Set as new remote host

This step is needed if you want to get more information about the project using the CLI.

Refer to this documentation on Create environment

platform project:set-remote <Project ID>

Push single branch to and activate it

Refer to this documentation on Create environment

# Push to
git push -u platform <Branch Name>

# Activate branch
platform environment:activate <Branch Name>

Get available URLs for the current project

Refer to this Documentation

platform url

SSH into your project

Refer to this documentation on SSH

platform ssh

Connect to the database using SSH tunneling

Refer to this documentation on SSH Tunneling

# List all possible commands
platform tunnel:list

# Open tunnel for all services
platform tunnel:open

# Connect to the remote database normally, as if it were local.
mysql --host= --port=30001 --user='user' --password='' --database='main'

Accessing log files

Refer to this documentation on logs

platform log --help