Common issues can arise when developing on Bento, or when deploying it to a server. This document lists known pitfalls that can be encountered and their solutions.
Useful commands used to diagnose and fix issues.
When a service is not behaving as expected, checking the service's logs for errors and warnings is always a good reflex.
The logs for each individual service can be accessed by running
./bentoctl.bash logs <service>
for example:
./bentoctl.bash logs katsu
If you want to follow the logs live, append the -f option. If no service is specified, logs
from all running Docker containers will be shown.
In some situations you may want to stop all services, perform environment changes or maintenance operations, then start all services again. To restart all services quickly
# Stop all services
./bentoctl.bash stop all
# Perform maintenance operations on host (optional)
git pull
./bentoctl.bash pull
# Start all services
./bentoctl.bash run allOne can also start and stop services individually, e.g.:
./bentoctl.bash run drs
./bentoctl.bash stop katsuIssues related to Docker.
How to notice: A service is experiencing issues and logs reveal it is trying to load a directory as a file.
Confirguration files for some services are provided to the container as file mounts,
such as Katsu's config.json file.
If the docker-compose of a service has a file mount that does not exsit on the host (e.g. lib/katsu/config.json),
Docker's default behaviour is to create a directory with said path.
This can lead the service to experience errors when trying to load the directory as a file. To fix this:
- Stop the service with:
bentoctl stop <service name> - Make sure the expected file exists in the host's path.
- Start the service with:
bentoctl run <service name> - Check the logs for errors:
bentoctl logs <service name>
How to notice: Services are experiencing errors because they are unable to read the contents of their volumes.
This is often a permission being denied because the host paths of volumes are owned by root, verify with:
ls -la ${BENTOV2_ROOT_DATA_DIR} # For data volumes
ls -la lib/ # For configuration volumesFind the faulty path(s) and the services they are associated with. Stop any service that is using said path(s), then change the ownership with:
sudo chown -R <username>:<username> <path>Where username is your username.
Finally, start the stopped services: bentoctl run <service>