What is the difference between a Platform, a Project and an Environment? 

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.

How can I cancel my subscription? 

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.

How do I delete my Platform.sh account? 

If you would like to delete your Platform.sh account, log in and select “Support” from the dropdown options when you click on your avatar in the top right hand corner of the management console. Create a new ticket, and request for your account to be deleted in the form provided there. A support agent will receive your request and delete your account shortly thereafter.

Does branching an environment duplicate services? 

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.

Do you have a local writable file-system? 

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.

What happens if I push a local branch to my project? 

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 platform environment:activate.

How does Master (the live site) scale? 

The 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.

What exactly am I SSHing into? 

The 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.

Can I edit a quick fix on a Platform environment without triggering a rebuild? 

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.

What do I see when I push code? 

When you 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 suppress the output, run platform push -W. The -W means --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.

What Linux distribution is Platform.sh using? 

Platform.sh is built on Debian.

If I choose the Development plan, can I use that plan for production? 

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.

I am getting weird errors when I push (something with paramiko..) 

Please validate the syntax of your YAML file. Don’t use tabs. If all fails, contact support.

Which geographic zones does Platform.sh cover? 

Platform.sh works with multiple cloud infrastructure providers, including Amazon Web Services, Microsoft Azure, Google Cloud, OVHcloud 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.

Why did you choose the .sh extension for your domain? 

‘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.

IDE Specific Tips 

MAMP pro:

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.

        Options FollowSymLinks
        AllowOverride All

Do you support MFA/2FA/TFA authentication? 

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.