Troubleshooting

Use these checks for common setup and maintenance problems.

dnf config-manager is missing

Some repository setup tasks require the DNF plugins package.

sudo dnf -y install dnf-plugins-core
make lab-stack

Ansible cannot find the inventory

Create the local inventory file from the new-machine setup page:

cat <<'EOF' > inventory
[local]
localhost ansible_connection=local ansible_python_interpreter=/usr/bin/python3
EOF
ansible-inventory -i inventory --list

Ansible collection is missing

Install the required collections before running the playbooks:

ansible-galaxy collection install community.general community.docker

Then rerun:

make lab-stack

Docker works only after logging in again

Docker group membership changes do not apply to already-running login sessions. Log out and back in, then check:

docker version
docker run --rm hello-world

Local services are not reachable

For services such as LanguageTool or GROBID, check that the container or service is running and that the documented port matches the client configuration.

docker ps
curl -f http://localhost:8081/v2/languages
curl -f http://localhost:8070/api/isalive

Use the service-specific Configuration pages for expected ports and startup commands.

Package audit reports unmanaged packages

Run the audit and review each finding:

make audit-packages

Resolve findings by adding deliberate workstation packages to Ansible-managed package lists, exact allowlists, or narrowly targeted regex allowlists. See Update software for the decision process.