Alpine Linux - User contributions [en]

ZNC

2019-12-31T19:57:07Z

Nbm: /* Run ZNC in a subdomain using NGINX */

[https://wiki.znc.in/ZNC ZNC] is an advanced IRC bouncer that can establish such a permanent connection to several IRC networks and channels so your IRC client (or multiple clients) can disconnect/reconnect without losing the chat session, while appearing as a single user to other users.

== Installation ==
Install the package that contains ZNC.
{{Cmd|apk add znc}}
Create a ZNC configuration file, this command will automatically create znc.conf in /var/lib/znc/configs/. You will be asked to enter some information.
{{Cmd|rc-service znc setup}}
{{Note|Make sure the information you enter is as it's shown below.}}
Listen on port: 1025
Listen using SSL: yes
Listen using both IPv4 and IPv6: no
Username: your_username
Enter password: your_password
Confirm password: your_password
Nick: nick
Alternate nick: nick_
Real name: optional
Bind host: try to leave empty
Set up a network? no
Launch ZNC now? no
{{Warning|Never edit the configuration file while ZNC is running; always check with <code>htop</code> or <code>rc-status</code> if ZNC is running.}}
Start ZNC as service.
{{Cmd|rc-service znc start}}

== Run ZNC in a subdomain using NGINX ==

=== Configure the ZNC webadmin page ===

Open the ZNC webadmin page <code>https://YOUR_SERVER_IP:1025</code> in your browser. Accept the insecure certificate and go forward.
Log in with your username and password and go to global settings.
We want to maintain the webadmin connections separate from the IRC connections.
Let's make a listening port for the IRC connections.

In Listen Port(s) add:

Port: 6697
BindHost: *
SSL: on
IPv4: on
IPv6: off
IRC: on
HTTP: off
URIPrefix: /
Save the information you entered and stop the service for now.
{{Cmd|rc-service znc stop}}
Edit the configuration file.
{{Cmd|vim /var/lib/znc/configs/znc.conf}}

{{Note|Listener0 is the webadmin port (it's listening port 1025). Listener1 is the IRC port (it's listening port 6697).}}
Your configuration file should look like this:

{{Cat|/lib/znc/configs/znc.conf|<nowiki>
<Listener listener0>
Allow IRC = false
AllowWeb = true
IPv4 = true
IPv6 = false
Port = 1025
SSL = false
URIPrefix = /

<Listener listener1>
AllowIRC = true
AllowWeb = false
IPv4 = true
IPv6 = false
Port = 6697
SSL = true
URIPrefix = /
</nowiki>
}}

Start ZNC as service.
{{Cmd|rc-service znc start}}

=== Configure NGINX ===
Install NGINX if you haven't already.
{{Cmd|apk add nginx}}
Create a configuration file in conf.d separated from the main configuration files.
{{Cmd|vim /etc/nginx/conf.d/znc.your_domain.com.conf}}
The file should look something like below.
{{Cat|/etc/nginx/conf.d/znc.your_domain.com.conf|<nowiki>
server {
server_name znc.yourdomain.com;
location / {
proxy_pass http://localhost:1025;
}
}
</nowiki>
}}
Restart the NGINX service.
{{Cmd|rc-service nginx restart}}

=== Set up SSL certificates ===
{{Note|We opt to use SSL certificates made by Let's Encrypt, instead of using the znc.pem certificate that comes with the program.}}
Install Certbot and its module to work with NGINX.
{{Cmd|apk add certbot cerbot-nginx}}
Run Certbot, this program will create Let's Encrypt SSL certificates for free. You will have to manually or automatically renew them every month.
{{Cmd|certbot}}
Restart NGINX and you're done. Your webadmin page will be automatically running the SSL certificate made by Let's Encrypt.
{{Cmd|rc-service nginx restart}}
Now we will replace the znc.pem certificate with the Let's Encrypt certificates for any person who wants to connect to our IRC bouncer. For this we need to concatenate two important files into znc.pem
{{Cmd|cat /etc/letsencrypt/live/your_domain.com/privkey.pem /etc/letsencrypt/live/your_domain.com/fullchain.pem > /var/lib/znc/znc.pem}}
[[Category:Server]]
[[Category:IRC]]

ZNC

2019-11-16T06:02:37Z

Nbm: /* Run ZNC in a subdomain using NGINX */ fixed little typo

[https://wiki.znc.in/ZNC ZNC] is an advanced IRC bouncer that can establish such a permanent connection to several IRC networks and channels so your IRC client (or multiple clients) can disconnect/reconnect without losing the chat session, while appearing as a single user to other users.

== Installation ==
Install the package that contains ZNC.
{{Cmd|apk add znc}}
Create a ZNC configuration file, this command will automatically create znc.conf in /var/lib/znc/configs/. You will be asked to enter some information.
{{Cmd|rc-service znc setup}}
{{Note|Make sure the information you enter is as it's shown below.}}
Listen on port: 1025
Listen using SSL: yes
Listen using both IPv4 and IPv6: no
Username: your_username
Enter password: your_password
Confirm password: your_password
Nick: nick
Alternate nick: nick_
Real name: optional
Bind host: try to leave empty
Set up a network? no
Launch ZNC now? no
{{Warning|Never edit the configuration file while ZNC is running; always check with <code>htop</code> or <code>rc-status</code> if ZNC is running.}}
Start ZNC as service.
{{Cmd|rc-service znc start}}

== Run ZNC in a subdomain using NGINX ==

=== Configure the ZNC webadmin page ===

Open the ZNC webadmin page <code>https://YOUR_SERVER_IP:1025</code> in your browser. Accept the insecure certificate and go forward.
Log in with your username and password and go to global settings.
We want to maintain the webadmin connections separate from the IRC connections.
Let's make a listening port for the IRC connections.

In Listen Port(s) add:

Port: 6697
BindHost: *
SSL: on
IPv4: on
IPv6: off
IRC: on
HTTP: off
URIPrefix: /
Save the information you entered and stop the service for now.
{{Cmd|rc-service znc stop}}
Edit the configuration file.
{{Cmd|vim /var/lib/znc/configs/znc.conf}}

{{Note|Listener0 is the webadmin port (it's listening port 1025). Listener1 is the IRC port (it's listening port 6697).}}
Your configuration file should look like this:

{{Cat|/lib/znc/configs/znc.conf|<nowiki>
<Listener listener0>
Allow IRC = false
AllowWeb = true
IPv4 = true
IPv6 = false
Port = 1025
SSL = false
URIPrefix = /
<Listener listener1>
AllowIRC = true
AllowWeb = false
IPv4 = true
IPv6 = false
Port = 6697
SSL = true
URIPrefix = /
</nowiki>
}}

Start ZNC as service.
{{Cmd|rc-service znc start}}

=== Configure NGINX ===
Install NGINX if you haven't already.
{{Cmd|apk add nginx}}
Create a configuration file in conf.d separated from the main configuration files.
{{Cmd|vim /etc/nginx/conf.d/znc.your_domain.com.conf}}
The file should look something like below.
{{Cat|/etc/nginx/conf.d/znc.your_domain.com.conf|<nowiki>
server {
server_name znc.yourdomain.com;
location / {
proxy_pass http://localhost:1025;
}
}
</nowiki>
}}
Restart the NGINX service.
{{Cmd|rc-service nginx restart}}

=== Set up SSL certificates ===
{{Note|We opt to use SSL certificates made by Let's Encrypt, instead of using the znc.pem certificate that comes with the program.}}
Install Certbot and its module to work with NGINX.
{{Cmd|apk add certbot cerbot-nginx}}
Run Certbot, this program will create Let's Encrypt SSL certificates for free. You will have to manually or automatically renew them every month.
{{Cmd|certbot}}
Restart NGINX and you're done. Your webadmin page will be automatically running the SSL certificate made by Let's Encrypt.
{{Cmd|rc-service nginx restart}}
Now we will replace the znc.pem certificate with the Let's Encrypt certificates for any person who wants to connect to our IRC bouncer. For this we need to concatenate two important files into znc.pem
{{Cmd|cat /etc/letsencrypt/live/your_domain.com/privkey.pem /etc/letsencrypt/live/your_domain.com/fullchain.pem > /var/lib/znc/znc.pem}}
[[Category:Server]]
[[Category:IRC]]