# ZNC Usage Welcome and thanks for helping with ZNC support! ## Register a team ZNC # Join your team channel and register a bouncer by typing !help # Connect to your ZNC by following the [bouncer connection guides](/bouncer/bouncer) # Get familiar with the different [IRC client types](/bouncer/bouncer). **Please download every single IRC client that you can and test them out.** Try logging in with each IRC client so you can better help support your users. # Ask a teammate to give your account admin powers by typing `/msg *controlpanel set admin true` ## Getting Started on IRC # Check the list of [IRC Networks](/ircnow/networks). Please connect to each network that your team has claimed, and join the #ircnow channel there. You will be the official support team for that network. # Join your team channels, #fruit and #fruit-team # Read all messages in your IRC team channel every day ## Getting Caught Up # Read all team emails sent to support@fruit.ircnow.org every day # Whenever you reply to a team email, make sure to either save a copy in the sent folder or bcc support@fruit.ircnow.org so your team has a record. # Read all emails sent to your personal user@ircnow.org account every day # All actions must be logged in [your team's wiki pages](/ircnow/servers) # For each action taken, report it on IRC # For major changes, email the entire team by sending to support@fruit.ircnow.org ## Service with a Smiley Chatting on IRC is hard. Requesting a ZNC is hard. Connecting to a ZNC is hard. Users need your help -- and they love service with a smiley# :) # Service with a smiley # Keep instructions short and easy to understand # Don't assume a user has successfully connected until he tells you so -- over 50%25 of users cannot figure out how to use ZNC # We support every IRC client known to man! # Remember, users -- not code or servers -- are the most important part of our network # Word of mouth from satisfied users are the best form of advertising 21:20 < user> !bnc 21:20 <@PLUM> user: Please check private message 21:20 < user> help what is the captcha 21:22 < user> type /msg PLUM !bnc captcha 235 21:24 < user> now how do i connect 21:24 <@staff> user: follow this guide: https://wiki.ircnow.org/index.php?n=Bouncer.MIRC 21:24 < user> ok 21:24 <@staff> type /server -m fruit.ircnow.org 1337 user/NETWORK:PASSWORD 21:25 <@staff> replace NETWORK with your network and PASSWORD with the password in the email 21:27 < user> thx works 21:28 <@staff> you're welcome user, please let your friends know about IRCNow! 21:29 < user> ok bye ## Check if Users Connected Never assume a user has connected successfully -- always check and verify. **Our job is not done until the user has connected is chatting!** You can load notify_connect if it has not been loaded already: /msg *status loadmod notify_connect notify_connect will send you a NOTICE message every time a user connects, so you can check if a user has connected. If you don't see the user connecting, then he must have incorrect settings and you will need to help him troubleshoot. ## Common Problems ### Can't read captcha If the user cannot read the captcha, check your #fruit-team channel. The bot should tell you what the captcha is. Or, you can ask the user to message you the captcha. Tell the user the number to message the bot: /msg !bnc captcha You can also just register the bouncer for the user if you know which email he is using. /msg !bnc /msg !bnc captcha The username and password will then be sent to the user. If the bot says you have already registered before, just change your nick using `/nick ` and then register again. ### How do I connect? To help a user connect to the bouncer, you can ask him which IRC client he is using or use CTCP VERSION: /ctcp version 23:54 [ctcp(Guest58404)] VERSION 23:54 CTCP VERSION reply from Guest58404: mIRC 7.30 In this example, the user is using mIRC 7.30. Look up the [mIRC guide](/bouncer/MIRC) and give the user the shortest, simple possible instructions to help him connect: 21:24 <@staff> type /server -m fruit.ircnow.org 1337 user/NETWORK:PASSWORD 21:25 <@staff> replace NETWORK with your network and PASSWORD with the password in the email 21:25 <@staff> full guide here: https://wiki.ircnow.org/index.php?n=Bouncer.MIRC 21:27 < user> thx works **IMPORTANT**: Every IRC client has different instructions. Make sure you have personally downloaded and tested as many [IRC clients](/bouncer/bouncer) as possible. You can't help users connect if you've never used the IRC client yourself. ## You are currently disconnected 13:41 <*status> You are currently disconnected from IRC. Use 'connect' to reconnect. There are two possibilities. First, it may be because you did not include your network in the password field. The password should be username/network:password, and not just the password by itself. (Yes, I know this is incredibly confusing, this is why [ZNC is flawed](/debate/zncflaws)) The user must type username/network:password and not just password, or else he will connect to the first network by default, which probably is not connected. Secondly, this may be because you are intentionally connecting to a new network that has not yet connected. If so, just type 'connect'. ### Network doesn't exist First, make sure the user has correctly typed in the password (it should have the form ysername/network:password). Secondly, double check that the network name was spelled correctly. If there are no mistakes, then you need to add the network: /msg *controlpanel addnetwork /msg *controlpanel addserver [[+]port] /msg *controlpanel reconnect Or you can use the webpanel: https://bnc.fruit.ircnow.org ### Why am I on the wrong network? Most likely because you didn't type in the password in the right way: 21:29 < user> why did u send me to the wrong network 21:30 <@staff> please follow the instructions *carefully*, you forgot to add user/NETWORK: 21:30 <@staff> type /server -m fruit.ircnow.org 1337 user/NETWORK:PASSWORD 21:31 <@staff> you *must* use user/NETWORK:PASSWORD and not just PASSWORD 21:25 <@staff> replace NETWORK with your network and PASSWORD with the password in the email 21:27 < user> thx sorry This happens because the user just puts a password like abcde12345 into the password field, but ZNC has this terrible approach where it requires users to put in user/NETWORK:abcde12345 to connect to NETWORK. It's extremely confusing and nobody ever understands it the first time. This is one reason why [ZNC is flawed](/debate/zncflaws). **NOTE**: Every IRC client has different instructions. You must read [the specific guide](/bouncer/bouncer) before helping a user. An alternative method for jumping networks is to type: /znc jumpnetwork NETWORK Replace NETWORK with the real network you want. ### Where is the web panel? https://bnc.fruit.ircnow.org Replace fruit with the real fruit name. ### How do I change my password? /msg *controlpanel set password He can also use the webpanel at https://bnc.fruit.ircnow.org Replace fruit with the real fruit name. ### What networks do you support? After a user connects, he should type: /msg *controlpanel listnetworks to list all available networks. ### How do I add a network? /msg *controlpanel addnetwork /msg *controlpanel addserver [[+]port] /msg *controlpanel reconnect Or you can use the webpanel: https://bnc.fruit.ircnow.org ### How do I delete all these networks? Don't. Tell the user it's a terrible idea to delete them because it will create extra work for everyone. Just keep the networks around because they are configured properly; if he tries to configure them himself, they will have tons of errors you must later fix. ### I can't connect Ask the user which fruit he tried to connect to (cherry, pear, mango, ...) and what IRC network he wants to chat on. Check the following: # Did the user successfully connect? - Load the notify_connect module and see if you can see the user's IP connecting. - If the user cannot connect to ZNC, then his IRC client has the wrong network settings. - If the user can connect to ZNC but cannot chat, then ZNC itself has the wrong settings and you must troubleshoot his connection for him. To fix his network settings, log in to the web panel: https://bnc.fruit.ircnow.org # Check the nickname/altnick - Some ircds like ngircd are unable to accept punctuation like [] in nicks - This could prevent your user from connecting # Double check the bindhost is set properly and that dns works ### Why am I GLINEd? 01:57 !irc.example.com *** You are banned from example.com (See http://irc.example.com/unban) Email admin@example.com for more information.) 01:57 -!- ERROR Closing Link: username [fruit.ircnow.org] (G:lined) GLINEs are caused either by misconfiguration in the ZNC server, [abuse from a user](openbsd/police) or a misconfiguration on the other network. You will need to ask a ZNC sysadmin to [request an iline](/openbsd/ilines). GLINEs are caused either by misconfiguration in the ZNC server, [abuse from a user](openbsd/police) or a misconfiguration on the other network. You will need to ask a ZNC sysadmin to [request an iline](/openbsd/ilines). ### How do I auto-identify on... dalnet: /msg *status loadmod perform /msg *perform Add PRIVMSG NickServ@services.dal.net :identify PASSWORD If you want to auto op yourself: /msg *perform Add PRIVMSG ChanServ@services.dal.net :op #chan freenode, rizon, oftc, snoonet: /msg *status loadmod nickserv /msg *nickserv set PASSWORD That will ensure you identify upon reconnect. To identify immediately, type: /msg NickServ identify PASSWORD ircnow: /msg *status loadmod perform /msg *perform Add SQUERY NickServ :identify PASSWORD If you want to auto op yourself: /msg *perform Add PRIVMSG ChanServ :op #chan undernet: /msg *status loadmod perform /msg *perform Add PRIVMSG X@channels.undernet.org :LOGIN /msg *perform Add mode +x quake: /msg *perform add PRIVMSG Q@CServe.quakenet.org :AUTH efnet, ircnet: There are no services here. We'll try to hold your nick using the bouncer but there is no way to register. ### How do I change my ident? My vhost? **WARNING**: Make sure to read the [security guide on phishing](/openbsd/phishing). Do not delete accounts or change vhosts without verifying the users own the email they registered with. There's currently no way to change the ident besides deleting the account and registering a new one. For the vhost, email the admins of your server at `support@fruit.ircnow.org`, replacing fruit with the actual fruit name. The email must come from the same email address they registered from. Or you can use IRC to message the [admins on the server](ircnow/servers). The user must be logged in to the ZNC to prevent [phishing](/openbsd/phishing). If the user is not logged in, don't change the vhost. For the vhost, email the admins of your server at `support@fruit.ircnow.org`, replacing fruit with the actual fruit name. The email must come from the same email address they registered from. Or you can use IRC to message the [admins on the server](ircnow/servers). The user must be logged in to the ZNC to prevent [phishing](/openbsd/phishing). If the user is not logged in, don't change the vhost. ### How do I delete my account or reset the password? **WARNING**: Make sure to read the [security guide on phishing](/openbsd/phishing). Do not reset users passwords unless you can confirm they own the email address they signed up with. Email the admins of your server at `support@fruit.ircnow.org`, replacing fruit with the actual fruit name. The email must come from the same email address they registered from. Or you can use IRC to message the [admins on the server](/ircnow/servers). An admin can reset the password as follows: /msg *controlpanel set password Send them an email from your team support account to the email they registered with when they signed up. Don't share with them the password over IRC to prevent phishing. To delete an account, type: /msg *blockuser block Again, don't block an account unless you can verify that they own the email address which was first used to sign up with. ### How can I log chats permanently? Don't. Your ZNC automatically saves messages for you to download when you connect. Simply turn on history logging for your IRC client. But there is currently no way for you to store messages forever. Don't use the log module. It would waste our disk space and there is no way for you to retrieve the logs anyway. ### How do I use SASL? /msg *status loadmod sasl /msg *sasl Mechanism plain /msg *sasl set **ZNC console** Connect [= /quote PASS admin:mysuperadminpassqwerty =] Generate new pass for user [= Go to site: https://passwordsgenerator.net/ and disable "Include Symbols" click "generate password" or you can create a password yourself (the password must be between 12 and 16 characters long and include numbers and letters) =] (:ifend:) User login [= username must be the same or derived from the network login (contain a suffix) =] Create new user [= /msg *controlpanel AddUser bob 12345678 /msg *controlpanel LoadModule bob perform =] Add network for new ner [= /msg *controlpanel AddNetwork bob IRCNow /msg *controlpanel AddServer vasya IRCNow irc.ircnow.org +6697 /msg *controlpanel SetNetwork BindHost bob IRCNow bob.fruit.ircnow.org /msg *controlpanel help =] Set channels [= /msg *controlpanel AddChan bob IRCNow #ircnow =] Set pass (this must be done with a user account or offer to run this command yourself) [= /msg *perform add PRIVMSG NickServ IDENTIFY bob 12345678 /msg *perform help =] Reconnect user`s network [= /msg *controlpanel Reconnect bob IRCNow =] Saving settings to disk (please save your changes to disk immediately) [= /msg *status SaveConfig =] Deleting user and user entities [= /msg *controlpanel DelUser bob /msg *controlpanel DelNetwork bob IRCNow =]