Oregon State University

Sieveshell - Email Filters


If you need to modify your Sieve email filters by hand rather than using the tools on the ONID web site, see the instructions below.

ONID email filtering rules use the Sieve language, which was designed specifically for email filtering. The Sieve language is formally defined in RFC 3028. There are many example Sieve filters that you can use as a starting point to learning the Sieve language. You can also look at the rules created by the tools on the ONID web site.

To begin, you'll need to SSH? to shell.onid.oregonstate.edu. Then execute sieveshell, specify the ONID mail server, and authenticate with your ONID password:

username@shell:~$ sieveshell imap.onid.oregonstate.edu
connecting to imap.onid.oregonstate.edu
Please enter your password: 

At the "> " prompt, you can type "help" to see a list of available commands:

> help
  sieveshell [-u username] [-a authname] [-r realm] <server>

help             - this screen
list             - list scripts on server
put <filename> [<target name>]
                 - upload script to server
get <name> [<filename>]
                 - get script. if no filename display to stdout
delete <name>    - delete script.
activate <name>  - set a script as the active script
deactivate       - deactivate all scripts
quit             - quit

Use the "list" command to view the Sieve scripts you have stored on the server, as well as which script is active.

> list
onid-web  <- active script

To save a script out into a file so that you can edit it, use the "get" command.

> get onid-web sieve.txt

After you have edited sieve.txt, use the "put" command to upload it.

> put sieve.txt onid-web

Note: If your Sieve script had errors in it, sieveshell will tell you the errors and not allow you upload the script.

The final step is marking your script as active, using the "activate" command.

> activate onid-web

Use the "quit" command to exit sieveshell when you are finished making changes.

We want your feedback!

Helpdocs are made just for you, so please tell us how we can make this information more clear and accessible. The more feedback that you can provide, the more we can improve our servies to you!


Contact Info

Copyright ©  2015 Oregon State University