On this page
Welcome to the
Built for developers, by developers. The efficient, reliable, and secure Platform-as-a-Service (PaaS) that gives development teams control and peace of mind while accelerating the time it takes to build and deploy applications.
Resources to help you customize, experiment, and optimize all from one platform.
There are different kinds of documentation. Some docs are useful when you’re just starting out, while others go into detail that’s relevant only after you’ve deployed many projects on Platform.sh.
This site is roughly split into categories based on where you are in your journey working with Platform.sh, described below.
If you’re still unfamiliar with Platform.sh and how it works, but you’re also looking to quickly start working with the platform, the Get started section is the right place to begin.
Learn the basics of how Platform.sh leverages Git to produce reusable build images, identical-to-production environments in staging and development (including production data), as well as the basics of monitoring and troubleshooting your environments.
Ready to get started? Let’s go!
After going through the Get started section, you may want to know more about how Platform.sh works and the logic behind it. The Learn section is a collection of tutorials and conceptual guides to help you understand the ins and outs of Platform.sh.
With this guide, find out which problem Platform.sh is trying to solve. Learn how Platform.sh’s configuration, build and deploy pipelines, and the structure of environments play into the broader philosophy behind reliably deploying applications.
Once you’re familiar with Platform.sh, its basic rules and philosophy, you may be curious about how you can replicate common workflows in other tools on our platform. From scheduling dependency updates and backups to exporting data, the Tutorials provide all the information you need.
Platform.sh makes deploying and managing infrastructure no different than working with Git. As your work becomes more experimental, however, you may be interested in optimizing your workflows, and addressing common constraints of the platform. The Best practices documentation contains articles that address advanced use cases for caching, microservices, and more.
Now that you understand the basic rules of Platform.sh, you’re likely ready to deploy your own custom code in a chosen framework. The Frameworks section is a collection of framework-specific how-to guides - from best practices to configuration, local development, and more.
The Reference documentation section is the largest and most comprehensive. It includes details of configuration, environment variables, activities, and much more material you can use in your day-to-day work.
Services on our platform are managed. You can provision them with a few lines of YAML and quickly connect them to the rest of your environment. No infrastructure expertise is required. Popular documentation: Like services, configure your application containers with one of many supported runtime Popular documentation: Delve deeper into how to configure containers, environments, projects, and repositories. Popular documentation: Learn more about how you can customize and optimize your deployed projects, and further experiment on the platform. Popular documentation:
Project & environment configuration
Services on our platform are managed. You can provision them with a few lines of YAML and quickly connect them to the rest of your environment. No infrastructure expertise is required.
Like services, configure your application containers with one of many supported runtime
Delve deeper into how to configure containers, environments, projects, and repositories.
Learn more about how you can customize and optimize your deployed projects, and further experiment on the platform.
Find out more about Platform.sh’s GIT implementation and REST API, and how you can leverage them to manage every aspect of your projects, through Platform.sh’s API documentation.
There are many resources available outside of the documentation that will help you work with Platform.sh, including demos, talks, and podcasts.
To stay informed of all the latest Platform.sh news, join our newsletter.
Have an experiment you’d like to share? Looking for a way to contribute?
Feel free to open an issue or pull request for any of the repositories below, or let us know on Slack if you find a problem we can help with:
If you’re experiencing issues with your projects, don’t hesitate to open a support ticket.