Take care: This article is maybe outdated or at least a bit neglected. It hasn't been updated for a while.

Install Symfony 3

Symfony has been around for some while — but it doesn't look old. Learn how to install and tune Symfony 2 or 3 on fortrabbit.

Get ready

We assume you've already created a New App and chose Symfony in the Software Preset. If not: You can do so in the fortrabbit Dashboard. You should also have a PHP development environment running on your local machine.

Root path

If you did not choose Symfony stack when creating the App in the Dashboard at first, please set the following: Go to the Dashboard and set the root path of your App's domains to web.

Change the root path for App URL of App: {{app-name}}

ENV vars

Go to the Dashboard and add the following environment variables to your App:


Go to ENV vars for the App: {{app-name}}

Quick start

For a new Symfony installation execute the commands following in your local terminal:

# 1. Use Composer to create a local Symfony project named like your App
$ composer create-project symfony/framework-standard-edition {{app-name}} "3.4.*"

# 2. Change into the folder
$ cd {{app-name}}

# 3. Initialize a local Git repo
$ git init .

# 4. Add all files
$ git add -A

# 5. Commit files for the first time
$ git commit -m 'Initial'

# 6. Add fortrabbit as a remote
$ git remote add fortrabbit {{ssh-user}}@deploy.{{region}}.frbit.com:{{app-name}}.git

# 7. Push changes to fortrabbit
$ git push -u fortrabbit main

# 8. After the first push you only need
$ git push

Got an error? Please see the access troubleshooting. Did it work? Cool! This first push can take a bit, since all the Composer packages need to be installed. When the push is done you can visit your App URL in the browser and see the Symfony welcome screen:

Advanced setup and migration

Until now this is a vanilla Symfony. It needs some more tinkering to make it yours.


The MySQL access details are available via environment variables. If you have chosen Symfony in the Stack chooser when creating the App, we will automatically create SYMFONY__DATABASE__* environment for you and you can use them as following (if you haven't chosen the right stack, please add those Symfony env vars manually, as shown above):

Open app/config/parameters.yml.dist and modify all database_* parameters:

    # ... keep above
    database_host: %database.host%
    database_port: %database.port%
    database_name: %database.name%
    database_user: %database.user%
    database_password: %database.password%
    # ... keep below

Use app_dev.php

If you want to use the development environment, you must modify web/app_dev.php. A simple example would be to replace the block, responding with a 403 like so:

if (isset($_SERVER['APP_NAME']) && $_SERVER['APP_NAME'] === '{{app-name}}') {
    // allow
} elseif (isset($_SERVER['HTTP_CLIENT_IP'])
    || isset($_SERVER['HTTP_X_FORWARDED_FOR'])
    || !(in_array(@$_SERVER['REMOTE_ADDR'], array('', 'fe80::1', '::1')) || php_sapi_name() === 'cli-server')
) {
    header('HTTP/1.0 403 Forbidden');
    exit('You are not allowed to access this file. Check '.basename(__FILE__).' for more information.');

This way you can easily decide per App whether you want to allow the dev mode or not.


In Universal stack, you can access all log files your App writes on the file system. If you want to use live logging in Universal stack or in Professional stack, then you should configure Symfony to use error_log. Modify the app/config/config_prod.yml file:

    # ..
        # ..
            type:  error_log
            # ..

Sending mail

You can not use sendmail on fortrabbit but you can use the SwiftmailerBundle and configure it in your app/config/config.yml file. Make sure you set the charset to UTF-8:



In Universal stack you can use the default file cache. In Professional stack, when you deploy your app, the old code is removed and the new one is deployed. If you need at some point to store custom information in the cache (through cache pools), you then need to avoid filesystem (because of the way the Professional stack works, with its distributed nodes): instead, use an adapter amongst doctrine, redis or memcached.

All articles

Craft CMS


Install guides

Code access














The Dashboard


Tips & tricks




Need individual help?
Learn about Company plans ›
Looking for an old article?
See the full list of articles ›
Found an error?
Contribute on GitHub ›