Last updated 18th May 2021
What is the difference between a Platform, a Project and an Environment?
WebPaas or Web PaaS 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 Web PaaS 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 Web PaaS account?
If you would like to delete your Web PaaS 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! Web PaaS 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
How does Master (the live site) scale?
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?
webpaas 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 WebPaas 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?
git push new code, Web PaaS 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
webpaas 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.
What Linux distribution is Web PaaS using?
Web PaaS 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 Web PaaS cover?
Web PaaS is currently available in France: Gravelines (GRA7).
IDE Specific Tips
In order for MAMP to work well with the symlinks created by the Web PaaS 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.
Did you find this guide useful?
Please feel free to give any suggestions in order to improve this documentation.
Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.
Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.
Thank you. Your feedback has been received.