1 files changed, 79 insertions, 0 deletions
diff --git a/doc/rspamadm.1.md b/doc/rspamadm.1.md
new file mode 100644
index 000000000..97c5d5146
--- /dev/null
+++ b/doc/rspamadm.1.md
@@ -0,0 +1,79 @@
+% RSPAMADM(1) Rspamd User Manual
+
+# NAME
+
+rspamadm - rspamd administration utility
+
+# SYNOPSIS
+
+rspamadm [*global_options*] [*command*] [*command_options*]...
+
+rspamadm -l
+
+rspamadm help
+
+rspamadm help <command>
+
+rspamadm --help
+
+# DESCRIPTION
+
+`rspamadm` is a routine to manage rspamd spam filtering system. It is intended to perform
+such actions as merging databases, performing configuration tests, encrypting passwords,
+signing configurations and so on. You can get a list of available commands by running
+
+    rspamadm -l
+
+# OPTIONS
+
+-h, \--help
+:   Show help message
+
+-v, \--verbose
+:   Enable verbose output
+
+-l, \--list-commands
+:   List available commands
+
+\--version
+:   Show version
+
+\--var=*value*
+:   Redefine ucl variable in format `VARIABLE=VALUE`
+
+# RETURN VALUE
+
+On exit `rspamadm` returns `0` if operation was successfull and an error code otherwise.
+
+# EXAMPLES
+
+Get help for pw command:
+
+    rspamadm help pw
+    rspamadm pw --help
+
+Encrypt controller's password:
+
+    rspamadm pw encrypt
+
+Merge fuzzy databases:
+
+    rspamadm fuzzy_merge -s data1.sqlite -s data2.sqlite -t dest.sqlite
+
+Perform configuration test:
+
+    rspamadm configtest -c rspamd.conf
+
+Test configuration strictly and redefine some ucl vars:
+
+    rspamadm --var=DBDIR=/tmp configtest -c ./rspamd.conf -s
+
+
+Generate a keypair to use for HTTPCrypt encryption:
+
+    rspamadm keypair
+
+# SEE ALSO
+
+Rspamd documentation and source codes may be downloaded from
+<https://rspamd.com/>.
+\ No newline at end of file