Deploy on Platform.sh

With just one click you can now deploy your project on Platform.sh.

Deploy on Platform.sh

Building a software business or an open-source community is hard enough. That's why we've built the Deploy on Platform.sh button—to enable users to launch software with a click from their web browser, with zero infrastructure configuration, no command lines, and all the services your application needs to run in production.

Your customers and prospects can skip long installation instructions and debugging of dependencies, and instead immediately onboard into your software without friction.

You can use the Deploy on Platform.sh button to grow your open-source project's user base, enable quick demos of your SaaS, or onboard new customers. Need help? We're on Slack, or you can email us here about partnerships.

How it works

The Deploy on Platform.sh button is a simple new way to deploy your software. You can add your button to any web page (including your GitHub pages) to enable your users to quickly launch a new project on our platform. With next to no configuration required, this button creates a link to an existing codebase template to deploy your project.

Step 1. Set up your Platform.sh configuration files
Step 1. Set up your Platform.sh configuration files

Platform.sh provides declarative infrastructure. Simply describe the services your application needs with simple YAML files, add those files to your public Git repository, and we take care of deploying your software and all its dependencies.

To make your application deployable on Platform.sh, you'll need three key files in your public Git repository: the .platform.app.yaml, services.yaml, and routes.yaml. These define the services your app needs (like MySQL, Redis, MongoDB, etc.), the layout of your application, any build or deploy steps required, and the routing between application containers.

You can find extensive documentation on how to set up your configuration files in our documentation site, and you can chat with our Developer Relations team on our public Slack channel.

Step 2. Create your Platform.sh template file
Step 2. Create your Platform.sh template file

Once you've created your configuration files, your application is deployable on Platform.sh. We'll take care of parsing those files and turning the configuration into running code in containers on our multicloud grid.

Now, to make your software discoverable, you'll want to add one more YAML file: the template-definition.yaml. This file provides Platform.sh with some extra metadata about your software, including a logo, description, keywords, and the public Git repository. Your template file will make it possible for users to deploy your software, and for Platform.sh to display metadata within the project creation process, and our 3rd Party Template Library.

Step 3. Generate your Deploy on Platform.sh button
Step 3. Generate your Deploy on Platform.sh button

To make it as straightforward as possible for users to discover and deploy your software, we've created a link builder, below. Simply paste in the full public URL of the template-definition.yaml you created in Step 2, and we'll generate a button link for you.

Build your deploy button

To get an embeddable snippet for your webpage, simply provide your project information below and click submit to generate your button.

Let's do this! Grab the link below and add it to your repo to get started.