8 Known issues
Twann edited this page 6 months ago

Known issues


Device slow to connect to the internet

Too much rules can cause your device to connect slowly to the internet, even to delay the boot time on Windows. The only way to fix that is to remove some filters or rules.


It is possible that you see the following error when trying to run TBlock:

Traceback (most recent call last):
  File "/home/user/.local/bin/tblock", line 5, in <module>
    from tblock.cli import run
ModuleNotFoundError: No module named 'tblock'

This error is probably caused by an non-root installation of the TBlock Python module.

To fix it, simply follow the steps below:

  1. Remove the tblock module installed only for the current user:
pip uninstall tblock
  1. Re-install it as root:
sudo pip install tblock

You can also install the package for your OS.

ERROR: failed to retrieve filter

Sometimes you could get an error like the one below:

Error image

Before doing anything else, check that you have access to the internet. If you can reach the internet, it means that you are probably using an obsolete version of the filter repository. To fix that, simply run as root:

tblock -Uyf

This command will force re-sync the filter repository and update all filters. Remember to do that at least once a month to prevent such issues to happen again.

WARNING: database has been updated

After an upgrading the TBlock package, you could sometimes get a message like that:

WARNING: database has been updated. Run "tblock -Yf" to finish update

Don't worry, this simply means that TBlock changed the structure of the database that contains rules and filters. This probably means that new features have been added to TBlock (for example filters mirrors in the version 1.3.0).

You just need to force re-sync the filter repository to avoid getting an error like this one. To do so, simply follow what the message says and run as root:

tblock -Yf

Database error

You can see the following error when trying to run TBlock:

ERROR: database error: please run "tblock -Yf" as superuser to resolve this problem

That simply means TBlock database is not yet created. To fix it, simply do what the error says:

sudo tblock -Y

If the error persist, your database may be corrupted. In this case, you can fix it, but you will loose all your rules and filters. To fix it, follow the steps below:

  1. Restore the default hosts file
sudo tblock --restore
  1. Remove tblock database
sudo rm -rf /var/lib/tblock/
  1. Setup the new database
sudo tblock --sync

Windows detecting TBlock as a malware

Windows often detects programs that are trying to edit the hosts file as malware.

Follow the Windows post-installation instructions to prevent that.

TBlock not executable on Windows after installation

There are three possible things that may cause that error.

  1. It can simply be the fact that you forgot to re-open the command prompt. To fix that, simply close your current command prompt/powershell window and open another one.
  2. If the problem persists, maybe TBlock flagged TBlock as a malware and is preventing it to work. Please refer to that issue.
  3. The installation uses a binary called PathEd to update the %PATH% environment variable. That executable needs the .NET Framework 2.0 to be installed in order to work. Try to run "C:\Program Files (x86)\TBlock\uninstall-tblock.exe" to uninstall TBlock, and then install it again. It should automatically prompt you to install the .NET Framework.

Other issues

If you suspect that you found a new issue, check the issue tracker. If you find an opened issue that describes yours, you can reply or react to it. Otherwise, you can open a new one or contact us to explain your issue.