please provide a valid cache path

[MiCoSa79]

Issue filing pre-requisites

• I've checked the documentation.
• I've looked for similar issues both Open and Closed.
• Ive tried clearing both cache and cookies in my browser or tried opening the app in the Incognito/InPrivate window.

Describe the bug

I try to install Invoiceshelf on ZimaOS using nginx as reverse proxy.

After installtion i get the following in the logfile:

invoiceshelf | ℹ️ Container Information
invoiceshelf | -------------------------------------
invoiceshelf |
invoiceshelf | OS: Alpine Linux v3.22
invoiceshelf | Docker user: www-data
invoiceshelf | Docker uid: 82
invoiceshelf | Docker gid: 82
invoiceshelf | OPcache: ✅ Enabled
invoiceshelf | PHP Version: 8.3.25
invoiceshelf | Image Version: v3.6.0-17759140407
invoiceshelf |
invoiceshelf | ℹ️ NOTICE (init-webserver-config): /etc/nginx/nginx.conf already exists, so we'll use the existing file.
invoiceshelf | ℹ️ NOTICE (init-webserver-config): /etc/nginx/site-opts.d/http.conf already exists, so we'll use the existing file.
invoiceshelf | ℹ️ NOTICE (init-webserver-config): /etc/nginx/site-opts.d/https.conf already exists, so we'll use the existing file.
invoiceshelf | ℹ️ NOTICE (init-webserver-config): /etc/nginx/conf.d/default.conf already exists, so we'll use the provided configuration.
invoiceshelf | Checking for Laravel automations...
invoiceshelf | 🚀 Clearing Laravel cache before attempting migrations...
invoiceshelf |
invoiceshelf | In Compiler.php line 75:
invoiceshelf |
invoiceshelf | Please provide a valid cache path.
invoiceshelf |
invoiceshelf |

when trying to reach the initial setup page, i get 502 bad gateway message.

What could be the issue?

What is the correct setting for APP_URL, SESSION_DOMAIN and SANCTUM_STATEFUL_DOMAINS?

Is it:

APP_URL: https://mysubdomain.mydomain.tld
SESSION_DOMAIN: mysubdomain.mydomain.tld
SANCTUM_STATEFUL_DOMAINS: mysubdomain.mydomain.tld

Any ports needed here?

Thanks for your help.

Steps to Reproduce the issue

Installed invoiceshelf using the docker compose file for mariadb

Expected behavior

I should be able to resch the initial setup page

Actual behavior

I am not able to reach the initial setup page.

InvoiceShelf version

nightly

Database type

mariadb

Database version

10

Web Browser

chrome

Server OS

ZimaOS

Reverse-proxy logs

Laravel/PHP/Container logs

see above

Other logs

[MatzeKitt]

For me, the solutions was to create additional directories within the storage directory:

// Source - https://stackoverflow.com/a/67274392
// Posted by Ranjan Kumar, modified by community. See post 'Timeline' for change history
// Retrieved 2026-01-28, License - CC BY-SA 4.0

cd storage/
mkdir -p framework/{sessions,views,cache}
chmod -R 775 framework

And additionally, just to be save: chown -R 82:82 framework/

[rihards-simanovics]

This is extremely odd. I recently was re-installing IS on a Coolify server which uses Docker and I haven't had any issues on neither the latest nor nightly releases.

To better understand what's happening, I need to know more about the environment you are running in because there must be some commonality. Which OS, what versions of OS and software. Otherwise, I can only close as can't reproduce.

[rihards-simanovics]

For me, the solutions was to create additional directories within the storage directory:

...

And additionally, just to be save: chown -R 82:82 framework/

Can you try to restart and then re-create the container and see if the issue returns.

[MatzeKitt]

I had the problem when adding the Docker configuration as a custom app in TrueNAS Community 25.10.1 - Goldeye.

Restarting and recreating the container did nothing after I initially created those mentioned directories.

[rihards-simanovics]

I had the problem when adding the Docker configuration as a custom app in TrueNAS Community 25.10.1 - Goldeye.

Restarting and recreating the container did nothing after I initially created those mentioned directories.

So then it's just that those three dirs don't get created on some systems. That's very odd, but I guess we can make an explicit command to ensure they exist in the entry script.