Skip to content

[BUG] Fresh install fails with "bootstrap/cache directory must be present and writable" #49

@p1r473

Description

@p1r473

Is there an existing issue for this?

  • I have searched the existing issues

Current Behavior

On a fresh install using the official image (lscr.io/linuxserver/speedtest-tracker:latest) and default volume mount to /config, the container fails to start. The logs report:
The /app/www/bootstrap/cache directory must be present and writable.
Manually inspecting the container confirms the directory does not exist on first launch. The application will not proceed without manually creating this directory.

Expected Behavior

The container should create /app/www/bootstrap/cache on first boot (or it should already be included in the image). It should be writable by the container user to avoid a fatal Laravel exception.

Steps To Reproduce

mkdir speedtest-tracker
cd speedtest-tracker
nano speedtest-tracker/docker-compose.yml
...
docker compose up -d
docker logs -n 50 speedtest-tracker

Environment

OS: Raspberry Pi OS Bookworm (Debian 12)
Docker installed: via apt package manager (docker-ce)
Architecture: aarch64 (Raspberry Pi 5)

CPU architecture

arm64

Docker creation

services:
  speedtest-tracker:
    image: lscr.io/linuxserver/speedtest-tracker:latest
    restart: unless-stopped
    container_name: speedtest-tracker
    ports:
      - 8444:443
    environment:
      - PUID=1000
      - PGID=1000
      - APP_KEY=REDACTED
      - DB_CONNECTION=sqlite
      - SPEEDTEST_SCHEDULE=*/30 * * * *
      - PRUNE_RESULTS_OLDER_THAN=30 days
    volumes:
      - ./config:/config

Container logs

#8 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1234): Illuminate\\Foundation\\Console\\Kernel->handle()
#9 /app/www/artisan(16): Illuminate\\Foundation\\Application->handleCommand()
#10 {main}
"}

In PackageManifest.php line 179:

  The /app/www/bootstrap/cache directory must be present and writable.


[2025-06-23 14:08:21] production.ERROR: The /app/www/bootstrap/cache directory must be present and writable. {"exception":"[object] (Exception(code: 0): The /app/www/bootstrap/cache directory must be present and writable. at /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php:179)
[stacktrace]
#0 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php(132): Illuminate\\Foundation\\PackageManifest->write()
#1 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php(108): Illuminate\\Foundation\\PackageManifest->build()
#2 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php(90): Illuminate\\Foundation\\PackageManifest->getManifest()
#3 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php(79): Illuminate\\Foundation\\PackageManifest->config()
#4 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/RegisterFacades.php(26): Illuminate\\Foundation\\PackageManifest->aliases()
#5 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(341): Illuminate\\Foundation\\Bootstrap\\RegisterFacades->bootstrap()
#6 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(473): Illuminate\\Foundation\\Application->bootstrapWith()
#7 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(195): Illuminate\\Foundation\\Console\\Kernel->bootstrap()
#8 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1234): Illuminate\\Foundation\\Console\\Kernel->handle()
#9 /app/www/artisan(16): Illuminate\\Foundation\\Application->handleCommand()
#10 {main}
"}

In PackageManifest.php line 179:

  The /app/www/bootstrap/cache directory must be present and writable.


[2025-06-23 14:08:22] production.ERROR: The /app/www/bootstrap/cache directory must be present and writable. {"exception":"[object] (Exception(code: 0): The /app/www/bootstrap/cache directory must be present and writable. at /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php:179)
[stacktrace]
#0 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php(132): Illuminate\\Foundation\\PackageManifest->write()
#1 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php(108): Illuminate\\Foundation\\PackageManifest->build()
#2 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php(90): Illuminate\\Foundation\\PackageManifest->getManifest()
#3 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php(79): Illuminate\\Foundation\\PackageManifest->config()
#4 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/RegisterFacades.php(26): Illuminate\\Foundation\\PackageManifest->aliases()
#5 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(341): Illuminate\\Foundation\\Bootstrap\\RegisterFacades->bootstrap()
#6 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(473): Illuminate\\Foundation\\Application->bootstrapWith()
#7 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(195): Illuminate\\Foundation\\Console\\Kernel->bootstrap()
#8 /app/www/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1234): Illuminate\\Foundation\\Console\\Kernel->handle()
#9 /app/www/artisan(16): Illuminate\\Foundation\\Application->handleCommand()
#10 {main}
"}

In PackageManifest.php line 179:

  The /app/www/bootstrap/cache directory must be present and writable.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status

    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions