Deploy on Platform.sh
Skip the command line and get more users for your project with one-click multi cloud deployment
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 from one multi cloud deployment platform.
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 onSlack, or you can email ushereabout partnerships.
Once you've set up a few files in your project for the Deploy on Platform.sh button, it can also be added to our publicsoftware marketplace. Contact us tolearn how.
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 multi cloud deployment 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
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 channelpublic Slack channel.
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 our3rd Party Template Library.
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.