How to run CraftCMS in subfolder with Nginx

Question

I'm trying to create a Nginx config which uses PHP-FPM for all routes starting with /craft and another proxy for all other routes (which should serve an Next.js app):

# Next.js upstream config
upstream nextjs {
  server host.docker.internal:3000;
}

# Proxy cache
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=STATIC:10m inactive=7d use_temp_path=off;

server {
  listen 80;
  listen [::]:80;
  server_name localhost;

  # Document root
  root   /var/www/html/web;
  index  index.php;

  # Logs
  access_log  /var/log/nginx/access.log main;
  error_log   /var/log/nginx/error.log warn;

  # Craft CMS
  location /craft {
    include "/etc/nginx/sites-shared/static-files.conf";
    try_files $uri $uri/ /index.php?$query_string;
  }

  location ~ [^/]\.php(/|$) {
    try_files $uri $uri/ /index.php?$query_string;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;

    fastcgi_pass              unix:/var/run/php-fpm/www.sock;

    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    fastcgi_param DOCUMENT_ROOT $realpath_root;
  }

  # Next.js's built assets
  # Browser cache - max cache headers from Next.js as build id in url
  # Server cache - valid forever (cleared after cache "inactive" period)
  location /_next/static {
    proxy_cache STATIC;
    proxy_pass http://nextjs;
  }

  # Next.js's static assets
  # Browser cache - "no-cache" headers from Next.js as no build id in url
  # Server cache - refresh regularly in case of changes
  location /static {
    proxy_cache STATIC;
    proxy_ignore_headers Cache-Control;
    proxy_cache_valid 60m;
    proxy_pass http://nextjs;
  }

  # Next.js app
  location / {
    proxy_pass http://nextjs;
  }
}

The installation works (running on https://foobar.dev:8843/craft/index.php?p=admin/install), but once I get redirected to https://foobar.dev:8843/craft/admin/dashboard, I get the following error:

2021/02/11 11:39:03 [error] 32#32: *1 rewrite or internal redirection cycle while internally redirecting to "/index.php", client: 172.20.0.1, server: localhost, request: "GET /craft/admin/dashboard HTTP/2.0", host: "foobar.dev:8843", referrer: "https://foobar.dev:8843/craft/index.php?p=admin/install"

That's my directory structure of /var/www/html:

.
└── /
    ├── config
    ├── modules
    ├── storage
    ├── templates
    ├── vendor
    ├── web/
    │   ├── app/
    │   │   └── index.php
    │   └── craft/
    │       ├── cpresources
    │       └── index.php
    ├── .env
    ├── composer.json
    ├── composer.lock
    └── craft

https://foobar.dev:8843/app/ works fine also, but it seems that rewrite of URLs does not work and I don't understand the mentionend redirection cycle in the error message.

i think you can just do `proxy_pass https://127.0.0.1:8843/app/` — Bijay Regmi, Feb 11 '21 at 12:05

score 0 · Answer 1 · answered Feb 11 '21 at 15:52

It's working fine with this configuration:

  # Craft CMS
  location /craft {
    try_files $uri $uri/ /craft/index.php?$query_string;
  }

  location ~ [^/]\.php(/|$) {
    # 404
    try_files                     $fastcgi_script_name =404;

    # default fastcgi_params
    include                       fastcgi_params;

    # fastcgi settings
    fastcgi_pass                  unix:/var/run/php-fpm/www.sock;
    fastcgi_index                 index.php;
    fastcgi_buffers               8 16k;
    fastcgi_buffer_size           32k;

    # fastcgi params
    fastcgi_param DOCUMENT_ROOT   $realpath_root;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
  }

score 0 · Answer 2 · answered Mar 22 '23 at 21:57

I couldn't get the answer on this page to work. So, after some troubleshooting with clues from this answer, here's my working nginx config. Hope it helps others.

    location ^~ /craft {
            index index.html index.htm index.php;
            alias /home/user/www/craft/web;
            if (!-e $request_filename) { rewrite ^ /craft/index.php last; }
            location ~ \.php$ {
                    try_files $uri =404;
                    fastcgi_split_path_info ^(.+\.php)(.*)$;
                    fastcgi_pass unix:/var/run/php-fpm.sock;
                    fastcgi_index index.php;
                    include fastcgi_params;
            }
    }

You will need to modify your alias subfolder and PHP socket or TCP listener.

How to run CraftCMS in subfolder with Nginx

2 Answers2