Installation/pt

Languages:

English

Existem várias possibilidades para instalar o ZNC na sua máquina$$$. A última versão está sempre disponível utilizando o tarball source de https://znc.in/releases.

Um ChangeLog está disponível no wiki. Pode também ler mais acerca da portabilidade do ZNC.

Qual das maneiras eu devo escolher para instalar o ZNC?

Se não tiver acesso root, a única maneira é utilizar o tarball source. Irá precisar de utilizar cmake .. -DCMAKE_INSTALL_PREFIX="$HOME/.local" como descrito.

Se tiver acesso root, pode utilizar o tarball source ou a maneira conveniente para a sua distro. Veja a secção sobre a sua distro para detalhes, mas esteja ciente que estes podem conter versões antigas do ZNC!

Quando tiver instalado o ZNC, pode criar um ficheiro config com znc --makeconf.

Versões de Desenvolvimento

Leia a págoma git se pretende obter a versão de desenvolvimente actual. Esteja ciente que esta pode ter mais bugs, mais funcionalidades, ser um bocado instável e comer a sua comida toda. Foi avisado(a)!

Tarball Source

Tarballs source oficiais podem ser encontradas aqui.

Se pretender compilar o ZNC com suporte para OpenSSL, irá precisar do pacote de desenvolvimento OpenSSL. No Debian/Ubuntu, este é chamado libssl-dev, No CentOS/Fedora/Red Hat, ele é openssl-devel e no openSUSE, ele é libopenssl-devel. Uma boa maneira de instalar esta e outras dependências é compilar as funcionalidade de dependência dos gestores de pacote (apt-get build-dep / yum-builddep / zypper source-install --build-deps-only).

1. Descarregar o último tarball source
2. tar -xzvf znc-Template:ZNC-Veersion.tar.gz
3. cd znc-1.9.1
4. mkdir build
5. cd build
6. cmake ..
   (utilize cmake .. -DCMAKE_INSTALL_PREFIX="$HOME/.local" se não pretender uma instalação para o sistema inteiro ou simplesmente não tem acesso root; utilize cmake -DOPENSSL_ROOT_DIR=/caminho/para/openssl se tiver um caminho não-standard do SSL)
   (utilize ccmake ou cmake-gui para ver outras opções de configuração)
7. make
   (Se estiver num servidor dedicado e se se o CPU tem mais de um núcleo, pode utilizar make -jX onde X é o número de núcleos de CPU para acelerar a compilação)
8. make install

Por favor, note que a compilação pode levar 5-10 minutos ou mais.

Quando tiver o ZNC instalado, pode utilizar znc --makeconf para fazer um ficheiro de configuração para o ZNC. Este config é guardado em ~/.znc sob o utilizador que o corre. Deve criar uma conta de utilizador não-root para o ZNC ser executado sobre ela.

O ZNC é executado ao apenas executar znc sob um utilizador znc dedicado, neste passo vai para plano de fundo. Ele não faz automaticamente um serviço init.d para ele próprio (que pode ser feito ao seguir as instruções de running ZNC as a system daemon) nem ele precisa de ser executado em screen ou algo parecido.

Veja a página FAQ se encontrar problemas.

Linux

Docker

O ZNC está disponível como uma imagem em Docker Hub, e pode ser descarregada com:

docker pull znc

Siga o link acima para instruções adicionais.

Se pretender testar as grandes funcionalidades (e bugs!), imagem de ZNC instável está aqui.

Debian

A Debian fornece pacotes ZNC que podem ser instalados utilizando (buster&bullseye/oldstable, bookworm/stable, trixie/testing, sid/unstable)

apt install znc

Debian Buster LTS backports

apt -t buster-backports install znc

Se pretender compilar o ZNC para obter a nova versão em vez da versão que a Debian fornece, pode precisar dos seguintes pacotes:

build-essential
libssl-dev
libperl-dev
pkg-config
libicu-dev

Pode utilizar o seguinte comando

aptitude build-dep znc

para instalar as dependências de compiação automaticamente. Note que algumas vezes estas build-depedencies estão desatulizados e não vão funcionar com a versão actual do ZNC.

Fedora/CentOS/Red Hat Enterprise Linux

A Fedora tem o ZNC empacotado no seu repositório principal e no repositório Extra Packages for Enterprise Linux (EPEL) deles e fornecem-nos CentOS/RHEL.

Se estiver a utilizar RHEL, instale o repositório EPEL ao descarregar o pacote ligado apropriado em webisite do EPEL.

Quando tiver o EPEL instalado (ou estiver no Fedora), execute:

sudo yum install znc

ou dnf

sudo dnf install znc

Uma vez instalado, pode configurar o ZNC ao correr:

sudo -u znc znc --makeconf # isto cria /var/lib/znc/.znc

Depois finalmente para o iniciar, pode executar:

sudo systemctl start znc # ou enable se pretender que ele se inicie automaticamente

Compilar a partir Source: CentOS 7+ apenas

Se realmente deseja compilar a partir do source, então por favor, siga as instruções aqui, escrito por Thomas Ward. Note que estas instruções utilizam o repositório EPEL de maneira a obter as dependências necessárias à compilação (e existem montes delas). Estas instruções funcionam perfeitamente uma instalação do ZNC básica. CentOS 7 ou mais recente é necessário por causa dos standards C++ utilizados e os CentOS mais antigos não têm os compiladores necessários para estes standards.

Ubuntu

Esta página lista todos os pacotes de ZNC nos repositórios Ubuntu.

Pode compilar o ZNC a partir do source ou utilizar um PPA que foi feito pelo membro da comunidade, para contem pacotes ZNC pré-construídos para todos os lançamentos suportados do Ubuntu. Note que o PPA não contém pacotes para todos lançamentos do Ubuntu e as datas de suporte para as várias versões do Ubuntu estão detalhadas aqui. Se o lançamento do Ubuntu em que você estiver não é suportado no PPA, terá de compilar a partir do source você mesmo(a).

Compilar a partir da Source

Se pretende compilar o ZNC a partir da source para obter a versão mais recente que o Ubuntu fornece, pode necessitar de determinar a capacidade do seu sistema em compilar ZNC 1.6.0 (e mais recente) baseado na versão do Ubuntu.

Compilar a partir do Git Master

Se estiver a tentar utilizar a versão master do Git do código-fonte, então irá tambem precisar de obter os seguintes pacotes e instalá-los. Não irá precisar de instalar estes se estiver a utilizar o tarball do lançamento estável, só se estiver a utilizar Git master:

aclocal
pkg-config
automake
autoconf

Depois de ter instalado estes pacotes, então continue em frente para as dependências adicionais que irá precisar.

Depois das dependências estarem instaladas, terá de executar autogen.sh para gerar o script configure.

Adicionar as Sources das Dependências de Compilação

Ubuntu 14.04

Se estiver no Ubuntu 14.04, irá precisar de adicionar um PPA ao seu sistema, com o seguinte comando:

sudo add-apt-repository -y ppa:teward/swig3.0

Mais recente que Ubuntu 14.04

Não irá precisar de adicionar quaisquer PPAs adicionais ou sources para dependências de compilação.

Outras Dependências de Compilão

Depois de verificar que tem as sources de dependência de compilação necessárias, irá precisar de instalar os seguintes pacotes:

build-essential
libssl-dev
libperl-dev
pkg-config
swig3.0
libicu-dev

Depois de fazer isto, pode seguir as instruções nesta página para compilar a partir da tarball source.

Instalar a partir de PPA

A Personal Package Archive (PPA) has been created by Thomas W., and contains the latest stable ZNC release as exists in Debian. It contains packages for all releases of Ubuntu that are currently supported. It does not contain packages for versions of Ubuntu that are past their end of life dates. Click here if you wish to see the details of the packages in the PPA.

The versions of ZNC currently available in the PPA are detailed on the repository's information page but will only receive updates for currently-supported, non End of Life Ubuntu Releases.

First, make sure you have the python-software-properties package installed:

sudo apt-get install python-software-properties software-properties-common

Then, add the PPA to your sources, and update the apt information:

sudo add-apt-repository ppa:teward/znc
sudo apt-get update

Then, install the znc packages:

sudo apt-get install znc znc-dev znc-perl znc-python znc-tcl

ZNC is now installed. You can create the configuration normally with this, when run on the user that you want to run ZNC as:

znc --makeconf

(open)SUSE

O ZNC faz parte dos repositórios oficiais. Para instalar, utilize o YaST GUI ou instale a partir da linha de comandos ao digitar

zypper install znc

Gentoo

Gentoo fornece pacotes de ZNC que podem ser instaladas utilizando:

emerge -av net-irc/znc

Several USE Flags can be used for znc:

• daemon (local): (not offically supported) Allow znc to run as a system-wide service. Installs an init script and creates a znc user:group.
• debug (global): enable debug
• ipv6 (global): adds support for ipv6
• perl (global): adds support for writing perl modules
• python (global): adds support for writing python 3 modules
• ssl (global): enable secure socket layer connections
• sasl (global): sasl support
• tcl (global): adds support for writing tcl modules

equery uses znc -a

Will print you a list of USE flags that will be used for znc

Slackware

Latest Slackware SBo Slackbuild

Alpine Linux

Para instalar o znc a partir do gestor de pacotes, introduza o seguinte comando:

sudo apk add znc znc-extra znc-modperl znc-modpython znc-modtcl ca-certificates

Se pretender compilar o ZNC a partir do source para obter a versão mais recente do que a Alpine fornece, precisa de instalar os seguintes pacotes com o comando:

sudo apk add autoconf automake gettext-dev g++ make openssl-dev pkgconfig zlib-dev 

Se pretender executar git, Debugging, perl, (requires swig), python, (requires swig), tcl, ou cyrus então instale o pacotes que correspondem:

sudo apk add git gdb perl-dev python3-dev swig tcl-dev cyrus-sasl-dev

Archlinux

O ZNC faz parte do repositório de pacotes da archlinux, e pode ser instalado com o seguinte:

pacman -S znc

Pode instalar adicionalmente as seguintes dependências opcionais para adicionar suporte para módulos adicionais.

• cyrus-sasl - módulo saslauth
• perl - módulo modperl
• python - módulo modpython
• tcl - módulo modtcl

Instável/Testing

Pode instalar o útlimo snapshot git a partir de Repositório do Utilizador Arch/AUR.

FreeBSD

O ZNC está nos ports do FreeBSD, apenas faça:

cd /usr/ports/irc/znc
make config
make install clean

ou pkg_add

pkg_add -r znc

ou pkgng

pkg install znc

Mac OS X/macOS

Há duas formas de instalar o ZNC no OS X, ou utilizando um gestor de pacotes como o Homebrew ou instalando você mesmo(a) a partir do source. Veja este post de blog para um tutorial de como compilar o ZNC a partir do source.

• NOTA: Se estiver a executar na arquitéctura PPC e não pode fazer ./configure && make && sudo make install, irá querer fazer o seguinte:

1. Certifique-se de que está a utilizar a flag --disable-perl para configure. Assim: ./configure --prefix=/usr/local --disable-perl

Homebrew

Instalar o Homebrew

Para mais informações acerca do Homebrew, veja aqui. O comando seguinte irá instalar o Homebrew para /usr/local

 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Homebrew precisa do Xcode e Mac OS X >= 10.5

Instalando o ZNC com o Homebrew

 brew install znc

Instalando o ZNC com o MacPorts

 port install znc

Microsoft Windows

Aviso: Se vai instalar o ZNC na sua máquina local com Windows, irá provavelmente ser inútil. Devia executá-lo nalguma máquina (Windows ou não), que esteja ligada à Internet 24/7.

Cygwin

O ZNC está disponível na lista de pacotes cygwin.

Descarregue o Cygwin, instale-o. Quando escolher na lista de pacotes para instalar, pesquise por "znc".

Se não pretende utilizar os pacotes fornecidos, pode compilar o ZNC a partir do source; para isso, irá necessitar dos seguintes pacotes instalados: automake, gcc-g++, libicu-devel, make, mpfr, pkg-config, openssl-devel, zlib-devel. Depois de instalados estes pacotes, prosiga para a secção Tarball Source (ou git)

WSL

Depois de se certificar que o WSL (Windows Subsystem for Linux) ele próprio funciona, siga as instruções em Linux.