Frequently Asked Questions (FAQ)
Platform or Platform.sh is the infrastructure which is running all your projects.
A project is the site that you’re working on. Each project corresponds to one Git repository. A project may contain multiple applications that will run in their own isolated containers. Each branch of a project may be deployed in its own environment.
An environment is a standalone copy of your site, complete with code, data, and running services. The
master branch is the production environment, while any other branch can be setup as an otherwise identical testing environment.
If you want to delete your project and cancel your subscription, simply go to your user profile and click on “Edit plan” on the project you want to delete. Then you can click on the link: “delete your Platform.sh plan”.
This will delete your project and stop invoicing for this project. If you have multiple projects, your subscription will continue until you don’t have any projects left.
Yes! Branching an environment creates an exact copy (snapshot) of the parent environment, containing the files, the database, and code. Each environment runs independently of every other, so if you have four active environments then you have four copies of your application, four copies of your database, four copies of your files, etc.
Yes! Platform.sh supports non-ephemeral storage. When you configure your application you can tell it what directories you want to be read/write. (These are called mounts.) These will be mounted on a distributed file system (which is transparent for you). When you backup your environment they will be backed up as well. When you create a new staging environment, these mounts will be cloned with the rest of your data.
If you push a local branch that you created with Git, you create what is called an
inactive environment, that is, an environment that is not deployed.
This means there won’t be any services attached to this branch.
You are able to convert an
inactive environment into an
active environment and vice versa back from the environment configuration page or using the CLI with
master environment gets a pool of resources based on your plan size, which is then split up between the applications and services you have defined. (For example, PHP 40%, MySQL 30%, Redis 10%, Solr 20%, etc). Increasing your plan size will increase the pool of CPU and RAM that gets split between each container.
All containers on development plans are “small” containers. See the sizing configuration page for more details.
platform ssh command allows you to log into your application container (where your PHP app or Node app or Java app is running). It is a fully running Linux environment, but almost all of the disk will be read-only, with the exception of mounts you have defined.
No. Changes to the code can only be made through deploying new Git commits. That ensures that “hot patches” don’t get lost in the net update, that all changes are auditable, and that if a security break-in happens the attacker still cannot modify your application code.
git push new code, Platform.sh rebuilds and redeploys the application. What shows on the command line is the output of your build process (composer, pip, bundler, etc. plus your own build hook) followed by the deploy process. It ends with a description of what was just deployed and the URLs that are now active.
To supress the output, run
platform push -W. The
--no-wait, and will disconnect the connection once the commits are pushed so that you can continue to use your local terminal. The exact same output is also available in the Web Management Console.
Platform.sh is built on Debian.
No. The Development plan provides all the tools to build your website. You can create as many development profiles as you wish for yourself and for your team. However, it does not allow for full production-level resources on the
master branch and does not allow you to configure a custom domain name.
Once your project is complete and ready for production, you can choose another plan to go live. These plans are available on the pricing page.
Please validate the syntax of your YAML file. Don’t use tabs. If all fails, contact support.
Platform.sh works with multiple cloud infrastructure providers, including Amazon Web Services, Microsoft Azure, Google Cloud, and Orange. We offer public Grid regions in several parts of the world: USA (East Coast), USA (West Coast), Canada (East Coast), Europe (Dublin), Europe (Germany), United Kingdom (London), and Australia (Sydney).
Dedicated projects can deploy production to any public AWS or Azure region.
‘sh’ is the short version of shell.
According to Wikipedia™, in computing, a shell is a user interface for access to an operating system’s services. Generally, operating system shells use either a command-line interface (CLI) or graphical user interface (GUI). This is exactly what Platform.sh is about: Giving developers tools to build, test, deploy, and run great websites!
“.sh” is also the TLD for Saint Helena that looks like a lovely island, and whose motto is: “Loyal and Unshakeable” which we also strive to be.
In order for MAMP to work well with the symlinks created by the Platform.sh CLI, add the following to the section under Hosts > Advanced called “Customized virtual host general settings.” For more details visit MAMP Pro documentation page.
<Directory> Options FollowSymLinks AllowOverride All </Directory>
When you specify your document root, MAMP will follow the symlink and substitute the actual build folder path. This means that when you rebuild your project locally, you will need to repoint the docroot to the symlink again so that it will refresh the build path.
Yes. We support Multi-Factor Authentication, and encourage its use. To do so please go to your Account Settings on our Account site. Then click on the left tab called Security which will let you enable an MFA Application.