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 install

Ansible cannot find the inventory

The local inventory is tracked in the repository. From the repository root, restore it if it was deleted and verify that Ansible can read it:

git restore inventory
ansible-inventory -i inventory --list

Ansible collection is missing

From the repository root, install the collections declared in requirements.yml:

make deps

Then rerun:

make install

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 Software pages for expected ports and startup commands.

Package audit reports unmanaged packages

Run the audit and review each finding:

make audit

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.