Development

Canasta: Using Canasta > Troubleshooting

This page covers common troubleshooting steps for Canasta installations.

Table of contents

Checking container status

To see if your Canasta containers are running:

cd /path/to/installation
sudo docker compose ps

Viewing container logs

To view logs from the web container:

cd /path/to/installation
sudo docker compose logs web

To follow logs in real-time:

sudo docker compose logs -f web

To view logs from all containers:

sudo docker compose logs

Accessing the database

To connect to the MySQL database directly:

cd /path/to/installation
sudo docker compose exec db mysql -u root -p

Enter the root database password from your .env file when prompted.


Running commands inside containers

To run arbitrary commands inside the web container:

cd /path/to/installation
sudo docker compose exec web <command>

For example, to check PHP version:

sudo docker compose exec web php -v

To get a shell inside the container:

sudo docker compose exec web bash

Common issues

Installation fails with "Canasta installation with the ID already exists"

Cannot connect to Docker

Wiki not accessible after creation

Permission denied errors