Permission denied (publickey)¶

SymfonyCloud leverages the SSH protocol to access running containers and Git over SSH for project deployments.

They are four possible reasons to why you might encounter this error:

1. Your public key has not been uploaded to SymfonyCloud. Check that your SSH key is properly uploaded using symfony account:ssh:keys. If your key is not present (or if you are not sure) use symfony account:ssh:key:add to upload it.

   Caution

   Please note that SymfonyCloud and SymfonyConnect SSH keys are currently differentiated: even if you previously uploaded your key to SymfonyConnect, you have to reupload it using the command mentioned above.

2. SSH keys propagation can take some time and you’ve been too fast. Try again to use symfony ssh or symfony env:deploy after a couple of minutes and it should work.

3. You’ve been recently added to a new project (only impacts symfony ssh): after adding new users to a project, a new deployment or a redeployment is required before the new users can access the project. If no deployment occurred since you’ve been granted access to the project, use symfony env:redeploy, wait for the end of the deployment and try again to access the project (this must be done for every environment).

4. You are using Windows.

   • When using symfony ssh, the SymfonyCloud client will make its best to use PuTTY registered SSH keys (connecting to Pageant) and OpenSSH keys saved in $HOME/.ssh (mimicking Unix). You can use symfony ssh -vvv to debug which keys are loaded by the SymfonyCloud client.

   • When using symfony deploy, some work is handed of to Git and the details then depends on your setup. We recommend you to use the following snippet to debug your issue:

     1 2 3

     set GIT_SSH_COMMAND=ssh -vvv set GIT_TRACE=2 git ls-remote [email protected]:test.git

Host key verification failed¶

This issue usually happens only on Windows

As for SSH authentication, on Windows, SymfonyCloud uses both PuTTY and OpenSSH directories for SSH host key verification, but symfony deploy is based on Git which is not using the same process. If you encounter this error message you can use git ls-remote test@git.eu.s5y.io:test.git to trigger a new connection and force Git to register the key.

Cannot decode encrypted private keys¶

See Unsupported key type.

Unsupported key type¶

SymfonyCloud leverages the SSH protocol to access running containers and Git over SSH for project deployments and might have to read your SSH keys to do so.

This error can happen in a very specific situation if the two following conditions are met:

• Your key is stored in the OpenSSH format; as opposed to the PEM format (in this case, the first line will look like -----BEGIN OPENSSH PRIVATE KEY-----)
• Your key uses the DSA or ECDSA algorithm (ssh-keygen -l -f <file> will tell you which algorithm is in use)

This use case is not yet supported by the upstream library we use. In the meantime you have two solutions:

1. Run an SSH agent and load your key using ssh-add <file>

2. Convert your private key back to PEM format: ssh-keygen -p -m pem -f <file>

   Caution

   This command upgrade your key inline. Please do a backup before!

Environment variable not found (during the build step)¶

SymfonyCloud leverages Symfony Runtime Environment Variables defining services connection information via environment variables (read the Connecting to a service from the services documentation for more information).

Additionally, to make containers reusable from one environment to another and to make (re-)deployments faster, the build step has no services started. Therefore the environment variables to connect to services are not available during the build step.

It might happen that an application build breaks because of an environment variable that does not exist:

Found 1 new commit

Building application 'myapp' (runtime type: php:7.3, tree: abcd123)
  Generating runtime configuration.

  Executing build hook...
  [...]
    W: Generating optimized autoload files
    W: > Incenteev\ParameterHandler\ScriptHandler::buildParameters
    Creating the "app/config/parameters.yml" file
    W: > Sensio\Bundle\DistributionBundle\Composer\ScriptHandler::buildBootstrap
    W: > Sensio\Bundle\DistributionBundle\Composer\ScriptHandler::clearCache

    In EnvVarProcessor.php line 76:

      Environment variable not found: "DATABASE_URL".


    W: Script Sensio\Bundle\DistributionBundle\Composer\ScriptHandler::clearCache
    W: handling the symfony-scripts event terminated with an exception
    W:
    W:
    W:   [RuntimeException]
    W:   An error occurred when executing the "'cache:clear --no-warmup'" command:
    W:
    W:
    W:
    W:
    W:   In EnvVarProcessor.php line 76:
    W:
    W:     Environment variable not found: "DATABASE_URL".
    W:
    W:
    W: install [--prefer-source] [--prefer-dist] [--dry-run] [--dev] [--no-dev]
    W: [--no-custom-installers] [--no-autoloader] [--no-scripts] [--no-progress]
    W: [--no-suggest] [-v|vv|vvv|--verbose] [-o|--optimize-autoloader]
    W: [-a|--classmap-authoritative] [--apcu-autoloader] [--ignore-platform-reqs]
    W: [--] [<packages>]...
    W:

  E: Error building project: The build hook failed with status code 1. Aborted build.

E: Error: Unable to build application, aborting.

This usually happens with applications migrated from Symfony pre 3.2 to 3.2 and upper. When migrating, one needs not to forget to define defaults in the .env file or in the service container configuration:

SQLSTATE[HY000] [2002] Connection refused (during the build step)¶

This error message is usually due to a known Doctrine bug/limitation.

Some parts of Doctrine configuration (such as Entities metadata build) need to know the exact database version to be built. This is usually done during Symfony cache warmup for more efficiency but this requires the database to be available, which is not is the case on SymfonyCloud.

The best long-term solution to this problem is to make sure no connection to the database is done during Symfony cache warmup. However, this solution might require to fix some third-party code or not be possible at all.

In this case, the best workaround to date is to explicitly tell Doctrine which database platform and version the application is going to use. This can be done either by updating the default DATABASE_URL in the .env file by appending ?serverVersion= and the targeted version or by updating the Doctrine semantic configuration under the keys driver and server_version:

Oops! An Error Occurred¶

This error message comes from your application and is generated by the default Symfony’s error template.

The server returned a “500 Internal Server Error”¶

If your application works locally but you see this message on SymfonyCloud it usually means you have a configuraton error or missing a dependency.

To fix this issue you have to inspect application logs, the cause of the error is usually specified in the error message:

1 2 3 4 5

$ symfony logs all [app] [14-Aug-2020 10:52:27 UTC] [critical] Uncaught PHP Exception Exception: [...] [app] [php.access] 2020-08-14T10:52:27Z GET 500 2.386 ms 2048 kB 419.11% / [access] 78.247.136.119 - - [14/Aug/2020:10:52:27 +0000] "GET / HTTP/1.1" 500 843 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.125 Safari/537.36"

If the error happens on a non production environment or on the main environment of a non production project you can also enable Symfony’s dev/debug mode to inspect the cause of the error:

1 2 3 4

# Enable debug mode $ symfony env:debug # Disable debug mode $ symfony env:debug --off

The server returned a “404 Not Found”¶

New Symfony applications comes without controllers by default. This means there’s no page to show as a homepage. When running your project locally you should have been welcomed with this page:

But with this page when running on SymfonyCloud:

This is because SymfonyCloud runs in production mode and as such Symfony shown a generic 404 error. To fix this, you will have to create your first Symfony page.

If you already created a custom page, check that all your files are commited, that you ran symfony deploy and it succeeded.

I want to rename the default (master) branch¶

Being able to rename the default branch on SymfonyCloud has many technical implications on the infrastructure that makes impossible for us to support this use case at the moment. Work is currently in progress to support this in the future.

In the meantime, one can work with another name locally by using the following procedure (we will assume the default Git branch is named main):

1
2

$ git checkout main
$ symfony env:link master

From now on, every SymfonyCloud operations made while main is the current Git branch will transparently apply to the SymfonyCloud master environment. Please note that on SymfonyCloud, the master word will continue to be used (SYMFONY_ENVIRONMENT, activity logs, non production URLs, etc…) and if you use the SYMFONY_ENVIRONMENT or the --env flag locally, they need to use the master value as well.