---
name: "bogoupgrade"
section: "1"
platform: "linux"
package: "bogofilter-db"
version: "1.2.5-12"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/bogoupgrade"
---

# bogoupgrade(1)

upgrades bogofilter database to current version

## NAME

bogoupgrade - upgrades bogofilter database to current version

## SYNOPSIS

**bogoupgrade** \[-h\] -d *directory* \[-i *input file*\] \[-o *output file*\] \[-b *path to bogoutil*\]

## DESCRIPTION

**bogoupgrade** is a command to upgrade bogofilter's databases from an old format to the current format. Since the format of the database changes once in a while, the utility is designed to make the upgrade easy.

## OPTIONS

The **-h** option prints the help message and exits.

The **-d** specifies the directory with the wordlists for converting. This option is used when converting from multiple, separate wordlists (spamlist.db and goodlist.db - containing spam and ham tokens, respectively) to a combined wordlist (wordlist.db) which contains both spam and ham tokens.

The **-i** specifies the input file to be converted. It should be a text file containing message counts, and possibly data. If there is no data in the text file, there should be a Berkeley DB file in the same directory as the text file which contains the data.

The **-o** specifies the output Berkeley DB file.

The **-b** gives the path to the **bogoutil** command. It defaults to 'bogoutil', in the hopes that your shell will find it.

## UPGRADING

Follow these instructions to upgrade bogofilter's databases to the latest version.

 1\. Stop all instances of bogofilter. While the upgrade tools lock the database files, the upgrade may take a long time if you have a busy site. Don't forget to stop cron jobs or daemons that fetch and process mail and could fire off bogofilter.

 2\. Backup your data. Let's assume that you said:

```
$ mv ~/.bogofilter ~/.bogofilter.safe
$ mkdir ~/.bogofilter
```

 3\. If your bogofilter version is less than 0.7, say:

```
$ bogoupgrade -i ~/.bogofilter.safe/goodlist -o ~/.bogofilter/goodlist.db
$ bogoupgrade -i ~/.bogofilter.safe/badlist -o ~/.bogofilter/spamlist.db
```

If your bogofilter version is 0.7 or greater, say:

```
$ bogoupgrade -i ~/.bogofilter.safe/hamlist.count -o ~/.bogofilter/goodlist.db
$ bogoupgrade -i ~/.bogofilter.safe/spamlist.count -o ~/.bogofilter/spamlist.db
```

 4\. Current versions of bogofilter use a combined wordlist that holds both spam and non-spam tokens. It is named wordlist.db. If you're updating from a version older than 0.14.0 that has separate wordlists (named goodlist.db and spamlist.db), use:

```
$ bogoupgrade -d ~/.bogofilter.safe
```

 5\. Done. Restart any stopped daemons, cron tasks, etc.

## AUTHOR

**bogoupgrade** was written by Gyepi Sam \<gyepi@praxis-sw.com\> and David Relson \<relson@osagesoftware.com\>.

For updates, see **the bogofilter project page**\[1\].

## SEE ALSO

[bogofilter(1)](/bogofilter/1.md), [bogolexer(1)](/bogolexer/1.md), [bogotune(1)](/bogotune/1.md), [bogoutil(1)](/bogoutil/1.md)

## NOTES

- 1\.

  the bogofilter project page

  http://bogofilter.sourceforge.net/