add svskill
[srvx.git] / FAQ
1 srvx Frequently Asked Questions
2 -------------------------------
3
4 This FAQ assumes that your services are named NickServ, ChanServ and
5 OpServ respectively.
6
7 Q1) How do I set up srvx?
8 A1) Read the README and INSTALL files, especially INSTALL.  If you are
9 upgrading from srvx-1.2, read UPGRADE.
10
11 Q2) How do I set up my IRC server so srvx talks to it?
12 A2) That depends on which IRC server you use.  Check its
13 documentation.  #srvx WILL NOT SUPPORT YOUR IRCD QUESTIONS.
14
15 Q3) I get "You must first authenticate with NickServ", help!
16 A3) To register an account, /msg NickServ@services.example.com
17 register YourName Password.  You must be a global IRC operator to
18 register the first account; srvx gives the first account "root" level
19 (1000) access.  To log in afterwards, use the "auth" command instead
20 of "register".
21
22 Q4) I do not like having to type "/msg NickServ@services.example.com"
23 for all of my commands.  How can I change that?
24 A4) If you want to disable that for the auth command, use "/msg OpServ
25 modcmd NickServ.auth flags -qualified".  However, that is a BAD idea:
26 if you have an auto-perform to log in, and you connect to some other
27 IRC network, you will send your password to whoever or whatever is
28 named NickServ on that network.
29
30 Q5) When I try to register a channel with ChanServ, it tells me I have
31 to have "security override" on.  Why?
32 A5-1) srvx's default configuration is to only allow network staff to
33 register channels.  For IRC operators and network helpers (users with
34 account flag +H), security override can be enabled by sending "/msg
35 ChanServ god on".  For support helpers (users with account flag +h),
36 security override is enabled when the user is in the configured
37 support channel.
38 A5-2) If you want to allow anyone to register channels, use "/msg
39 OpServ modcmd ChanServ.register flags -helping".
40
41 Q6) How do I enable HelpServ?
42 A6) When you run the "configure" script, you must enable the helpserv
43 module; for example, "./configure --enable-modules=helpserv".  After
44 you compile and start srvx with that option, "/msg OpServ bind OpServ
45 helpserv *helpserv.helpserv".  After that, you can use "/msg OpServ
46 helpserv help" and "/msg OpServ helpserv register"; the "helpserv"
47 command acts as a gateway into the HelpServ system.
48
49 Q7) How do I enable MemoServ?
50 A7) When you run the "configure" script, you must enable the MemoServ
51 module; for example, "./configure --enable-modules=memoserv".  Then
52 see the comment near the start of src/mod-memoserv.c for configuration
53 options.
54
55 Q8) How do I enable both HelpServ and MemoServ?
56 A8) In addition to the post-install configuration steps above, you
57 must mention both when you run the configure script.  For example, run
58 it using "./configure --enable-modules=memoserv,helpserv".  (You may
59 add the snoop and/or sockcheck modules as well; separate the module
60 names with commas.)