Troubleshooting FAQ

  • How many times per hour shall I run freshclam?

If you are running ClamAV 0.7x please upgrade now.

If you are running ClamAV 0.8x or later, you can check for database update as often as 4 times per hour provided that you have the following options in freshclam.conf: DNSDatabaseInfo DatabaseMirror DatabaseMirror Replace XY with your “country code”:iana. If you don’t have that option, then you must stick with 1 check per hour.

  • I tried to submit a sample through the web interface, but it said the sample is already recognized by ClamAV. My clamscan tells me it’s not. I have already updated my database and ClamAV engine, what’s wrong with my setup?

Please run clamscan with the --detect-broken option. Also check that freshclam and clamscan are using the same path for storing/reading the database.

  • I found an infected file in my HD/floppy/mailbox, but ClamAV doesn’t recognize it yet. Can you help me?

Our virus database is kept up to date with the help of the community. Whenever you find a new virus which is not detected by ClamAV you should “complete this form”:submit. The virusdb team will review your submission and update the database if necessary. Before submitting a new sample: - check that the value of DatabaseDirectory, in both clamd.conf and freshclam.conf, is the same - update your database by running freshclam

  • How do I keep my virus database up to date?

ClamAV comes with freshclam, a tool which periodically checks for new database releases and keeps your database up to date.

  • I get this error when running freshclam: Invalid DNS reply. Falling back to HTTP mode or ERROR: Can’t query . What does it mean?

There is a problem with your DNS server. Please check the entries in /etc/resolv.conf and verify that you can resolve the TXT record manually: $ host -t txt If you can’t, it means your network is broken. You’ll be still able to download the updates, but you’ll waste a lot of bandwidth checking for updates.

  • I get this error when running freshclam: ERROR: Connection with ??? failed . What shall I do?

Either your dns servers are not working or you are blocking port 53/tcp. You should manually check that you can resolve hostnames with: $ host If it doesn’t work, check your dns settings in /etc/resolv.conf. If it works, check that you can receive dns answers longer than 512 bytes, e.g. check that your firewall is not blocking packets which originate from port 53/tcp. An easy way to find it out is: $ dig

  • How do I know if my IP address has been blacklisted?

Try to download daily.cvd with lynx or wget from the same machine that is running freshclam. Future versions of freshclam will provide a better way to deal with this.

  • What is the mirrors.dat file?

mirrors.dat is used by freshclam to keep track of broken mirrors. It avoids the unnecessary delays caused by trying to download a CVD update from a mirror which failed multiple times during the last 24 hours.

  • I’m running ClamAV on a lot of clients on my local network. Can I serve the cvd files from a local server so that each client doesn’t have to download them from your servers?

Sure, there are two possible solutions.

  • If you want to take advantage of incremental updates, install a proxy server and then configure your freshclam clients to use it (watch for the HTTPProxyServer parameter in man freshclam.conf).
  • The second possible solution is to configure a local webserver on one of your machines (say machine1.mylan) and let freshclam download the *.cvd files from to the webserver’s DocumentRoot. Finally, change freshclam.conf on your clients so that it reads: DatabaseMirror machine1.mylan. First the database will be downloaded to the local webserver and then the other clients on the network will update their copy of the database from it. For this to work, you have to add ScriptedUpdates off on all of your machines!
    • I can’t wait for you to update the database! I need to use the new signature NOW!

    No problem, save your own signatures in a text file with the appropriate extension (see “signatures.pdf”:/doc/latest/signatures.pdf for more information). Put it in the same dir where the .cvd files are located. ClamAV will load it after the official .cvd files. You need not to sign the .db file.

    • Can I download the virusdb manually?

    Yes, the virusdb can be downloaded from the Latest releases section on our home page.

    • I can’t resolve! Is there a problem with your/my DNS servers? has got only a TXT record, not a type A record! Try this command: $ host -t txt Please note that some not RFC compliant DNS servers (namely the one shipped with the Alcatel (now Thomson) SpeedTouch 510 modem) can’t resolve TXT record. If that’s the case, please recompile ClamAV with the flag --enable-dns-fix .

    Last update: Apr 7, 2009