Important

You are browsing the documentation for version 3.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get the updated information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Web Server Configuration

The following sections contain the recommended configuration for supported web server types and versions.

Apache 2.4

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
    <VirtualHost *:80>
        ServerName <your-domain-name>
        ServerAlias www.<your-domain-name>

        DirectoryIndex index.php
        DocumentRoot <application-root-folder>/public
        <Directory  <application-root-folder>/public>
            # enable the .htaccess rewrites
            AllowOverride All
            Require all granted
        </Directory>

        ErrorLog /var/log/apache2/<your-domain-name>_error.log
        CustomLog /var/log/apache2/<your-domain-name>_access.log combined
    </VirtualHost>
  • Replace <application-root-folder> with the absolute path to the Oro application.
  • Replace <your-domain-name> with the configured domain name that is used for the Oro application.

Note

Please make sure mod_rewrite and mod_headers are enabled.

Nginx

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
    server {
        server_name <your-domain-name> www.<your-domain-name>;
        root <application-root-folder>/public;

        location / {
            # try to serve file directly, fallback to index.php
            try_files $uri /index.php$is_args$args;
        }

        location ~ ^/(index|index_dev|config|install)\.php(/|$) {
            fastcgi_pass 127.0.0.1:9000;
            # or
            # fastcgi_pass unix:/var/run/php/php7-fpm.sock;
            fastcgi_split_path_info ^(.+\.php)(/.*)$;
            include fastcgi_params;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            fastcgi_param HTTPS off;
        }

        location ~* ^[^(\.php)]+\.(jpg|jpeg|gif|png|ico|css|pdf|ppt|txt|bmp|rtf|js)$ {
           access_log off;
           expires 1h;
           add_header Cache-Control public;
        }

        error_log /var/log/nginx/<your-domain-name>_error.log;
        access_log /var/log/nginx/<your-domain-name>_access.log;
    }
  • Replace <application-root-folder> with the absolute path to the Oro application.
  • Replace <your-domain-name> with the configured domain name that is used for the Oro application.

Caution

Make sure that the web server user has permissions for the log directory of the application.

More details on the file permissions configuration are available in the official Symfony documentation.