Troubleshooting

This guide helps you resolve common issues when running TaskTrove.

⚠️ Permission Error

Error Message:

Unable to access data directory. Check volume mounts and permissions.

Root Cause

TaskTrove cannot access the /app/data directory inside the container, typically due to missing host directory or lacking read/write permissions.

Your data is stored in the mounted data directory (e.g. ./data) on your host system, and mounted to /app/data inside the container.

This file is automatically created when TaskTrove starts successfully, unless the container does not have read/write permissions to the mounted data directory.

Quick Fix

Step 1: Create the data directory

mkdir -p ./data

Step 2: Run TaskTrove with proper volume mounting

docker run -p 3000:3000 -v ./data:/app/data -d --name tasktrove ghcr.io/dohsimpson/tasktrove

Note the -v flag, which mounts the ./data directory from your host system to the /app/data directory inside the container.

Step 3: Check Permissions If the directory exists but TaskTrove still can't access it:

# Set proper permissions
chmod 755 ./data

# For persistent permission issues, match container user
sudo chown -R 1000:1000 ./data

Verify Setup

Check that TaskTrove can access the data directory:

# View container logs
docker logs tasktrove

# Test data directory access
docker exec tasktrove ls -la /app/data
docker exec tasktrove cat /app/data/data.json