Troubleshooting

Bug reporting guidelines

You are facing an issue with WordOps ? Please ask you the following questions before opening an issue on Github or creating a post on the forum :

  • Are you using the latest release of WordOps ? -> if not, update WordOps first and try again to see if your issue still exist.
  • Is it a known issue ? -> use the search feature in the documentation, in the forum and in Github issues to check if it's a known issue
  • Have you checked the logs ? -> always check the content of /var/log/wo/wordops.log to check what is exactly the task which failed
  • Is the issue directly related to WordOps ? -> for questions or support, please use the community forum.

Then, if the issue still exist and if there is no solution or workaround available, feel free to open an issue on Github

Common issues

The command wo update failed

This is a known issue with WordOps v3.9.6 which has been fixed with the maintenance release v3.9.6.1. As a workaround you can either use the command wo update --beta or run again the install command:

wget -qO wo wops.cc && sudo bash wo

WordOps failed to issue SSL certificate

At first, make sure your domain is pointed to your server IP:

  • www.site.tld + site.tld if you use the flag -le or --letsencrypt
  • sub.site.tld if you use the flag -le=subdomain or --letsencrypt=subdomain

Then if you need to cleanup the previous SSL certificate, you can use the following command to remove existant certificates and keys, as well as other Nginx configurations for your domain:

wo site update site.tld --letsencrypt=clean

When I update a page, changes are not applied on the site

If you are using Nginx fastcgi_cache, please make sure:

  • Nginx-helper plugin is enabled
  • the option "purge cache" is enabled in Settings > Nginx-Helper
  • the caching method is defined on Nginx Fastcgi cache

If you are using Redis-cache, please make sure:

  • Nginx-helper plugin is enabled
  • the option "purge cache" is enabled in Settings > Nginx-Helper
  • the caching method is defined on Redis Cache
  • the prefix defined is nginx-cache:

WordOps commands are not working

If the error output looks like:

Traceback (most recent call last):
  File "/usr/local/bin/wo", line 6, in <module>
    from pkg_resources import load_entry_point
  File "/usr/lib/python3/dist-packages/pkg_resources/__init__.py", line 3088, in <module>
    @_call_aside
  File "/usr/lib/python3/dist-packages/pkg_resources/__init__.py", line 3072, in _call_aside
    f(*args, **kwargs)
  File "/usr/lib/python3/dist-packages/pkg_resources/__init__.py", line 3101, in _initialize_master_working_set
    working_set = WorkingSet._build_master()
  File "/usr/lib/python3/dist-packages/pkg_resources/__init__.py", line 574, in _build_master
    ws.require(__requires__)
  File "/usr/lib/python3/dist-packages/pkg_resources/__init__.py", line 892, in require
    needed = self.resolve(parse_requirements(requirements))
  File "/usr/lib/python3/dist-packages/pkg_resources/__init__.py", line 778, in resolve
    raise DistributionNotFound(req, requirers)
pkg_resources.DistributionNotFound: The 'wo==3.9.8.2' distribution was not found and is required by the application

Just remove the executable /usr/local/bin/wo and reinstall WordOps:

sudo rm /usr/local/bin/wo && wget -qO wo wops.cc && sudo bash wo