Como instalar o Kliqqi no Ubuntu

Kliqqi é um sistema de gestão de conteúdo para comunidades sociais que permite criar redes sociais responsivas e com bom design, semelhantes ao Twitter ou Facebook. Com Kliqqi você pode hospedar sua própria rede social privada ou pública. Neste tutorial veremos como instalar o Kliqqi em um servidor Ubuntu.

Pré-requisitos

Assumimos que você tem um servidor Ubuntu (por exemplo Ubuntu 18.04, 20.04 ou posterior). Você precisará dos seguintes pacotes instalados e em execução:

• Apache2
• PHP — pelo menos versão 5.4 (recomenda-se PHP 7.2+ hoje)
• MySQL — pelo menos versão 5.1 (ou MariaDB equivalente)

Recomendações extras: instale módulos PHP comuns exigidos por aplicações web sociais, por exemplo php-mysql, php-gd, php-curl, php-xml, unzip e habilite o firewall UFW conforme necessário.

Importante: em servidores de produção prefira versões de PHP e MySQL suportadas e atualizadas pelo seu SO para receber correções de segurança.

Passo 1 — Criar o banco de dados Kliqqi

No servidor, conecte-se ao MySQL como root e crie o banco de dados Kliqqi:

mysql -u root -p
CREATE DATABASE kliqqi;

Saia do console do MySQL com exit ou \q.

Passo 2 — Criar usuário do banco de dados

Crie um usuário dedicado para o Kliqqi e conceda privilégios apenas no banco criado. Substitua ‘password’ por uma senha forte.

GRANT ALL PRIVILEGES ON `kliqqi`.* TO 'kliqquser'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Observação: em ambientes com acesso remoto ao banco, restrinja o host e considere usar conexões seguras.

Passo 3 — Baixar e colocar os arquivos do Kliqqi

Baixe a versão estável do site oficial. Ajuste a URL/version conforme necessário.

wget -c https://www.kliqqi.com/download/2268/ -O Kliqqi1112017.zip

Extraia o arquivo baixado:

unzip Kliqqi1112017.zip

Após a extração, mova o diretório resultante para a raiz web do Apache. Dependendo do nome da pasta extraída, ajuste o comando:

sudo mv Kliqqi /var/www/kliqqi

Altere a propriedade para o usuário do Apache (www-data) e permissões básicas:

sudo chown -R www-data:www-data /var/www/kliqqi
sudo chmod -R 755 /var/www/kliqqi

Notas: confirme o nome do diretório após a extração. Se o arquivo zip extrair para Kliqqi1112017, adapte o mv.

Passo 4 — Configurar VirtualHost do Apache (HTTP)

Crie um arquivo de configuração em /etc/apache2/sites-available/kliqqi.conf com o seguinte conteúdo (substitua o ServerName pelo seu domínio):

    ServerName kliqqi.exemploservidor.xyz
    DocumentRoot /var/www/kliqqi
    
        Options -Indexes +FollowSymLinks +MultiViews
        AllowOverride All
        Require all granted
    
    ErrorLog ${APACHE_LOG_DIR}/kliqqi.exemploservidor.xyz-error.log
    CustomLog ${APACHE_LOG_DIR}/kliqqi.exemploservidor.xyz-access.log combined

Habilite o site e recarregue o Apache:

sudo a2ensite kliqqi.conf
sudo systemctl reload apache2

Se usar HTTPS, crie primeiramente o VirtualHost em :443 e gere o certificado TLS (Let’s Encrypt é uma opção grátis). Ver seção Segurança abaixo.

Passo 5 — Executar o assistente de instalação via web

Abra um navegador e aponte para http://seu-dominio/install/install.php. O instalador web guiará pelos passos:

1. Seleção de idioma.
2. Validação das configurações do servidor e requisitos.
3. Inserção das credenciais do banco de dados (use o usuário criado acima).
4. Criação das tabelas do banco e cadastro do administrador.

Preencha os dados e clique em “Check Settings” (Verificar configurações). Se a verificação passar, prossiga até a criação do esquema e do administrador.

Quando a instalação terminar, faça login no painel administrativo com as credenciais criadas.

A interface do administrador permitirá configurar temas, plugins, usuários e políticas da comunidade.

No front-end você e seus usuários poderão publicar posts, criar grupos, seguir outros usuários e mais.

Use o menu “Groups” para criar ou procurar grupos.

E acesse o perfil para editar informações pessoais e ver seguidores.

Verificações pós-instalação (Checklist rápido)

• Confirmar que o site carrega sem erros PHP.
• Testar criação de usuário e publicação de conteúdo.
• Verificar logs do Apache (erros/permissões).
• Fazer backup inicial do banco e dos arquivos (export SQL + cópia do diretório).
• Habilitar HTTPS e redirecionamento 301 de HTTP para HTTPS.

Segurança e boas práticas

• Habilite HTTPS com certbot/Let’s Encrypt: gere certificados e configure o VirtualHost :443.
• Restrinja permissões de arquivo: evite 777.
• Mantenha o sistema e pacotes PHP atualizados.
• Faça backups periódicos do diretório /var/www/kliqqi e do banco de dados.
• Considere proteção contra brute force no painel de login (fail2ban, limite de tentativas).

Solução de problemas comuns

Problema: “Erro de conexão com o banco” — Verifique usuário, senha, host e se o MySQL está ouvindo em localhost. Confirme que as tabelas foram criadas e que o arquivo de configuração do Kliqqi tem as credenciais corretas.

Problema: Permissões 403 — Confirme o dono dos arquivos (www-data) e as diretivas AllowOverride All no VirtualHost, além de Options corretas.

Problema: Erros PHP (módulos faltando) — Instale pacotes como php-mysql, php-gd, php-curl e reinicie o Apache.

Migração e upgrade — dicas rápidas

• Para mover a instalação, copie os arquivos e exporte/import o banco (mysqldump).
• Antes de atualizar o Kliqqi, faça backup total e teste a atualização em ambiente de staging.
• Verifique a compatibilidade de versões PHP exigidas por novas versões do Kliqqi.

Checklist por função

Admin de sistema:

• Instalar dependências, configurar Apache, backup e monitoramento.

Administrador do site (community manager):

• Configurar políticas, moderação, criar categorias e grupos.

Desenvolvedor:

• Revisar código customizado, configurar ambiente de testes, aplicar patches.

Quando o Kliqqi pode não ser a melhor escolha

• Se você precisa de recursos avançados de federação ou integração SSO pronta, plataformas maiores (ou soluções específicas) podem ser mais adequadas.
• Para projetos com alto tráfego, avalie escalabilidade: cache, CDN e infraestrutura mais robusta podem ser necessários.

Mini glossário (1 linha cada)

• VirtualHost: configuração do Apache que define como um domínio serve arquivos.
• DocumentRoot: pasta onde estão os arquivos públicos do site.
• mysqldump: utilitário para exportar bancos MySQL.

Checklist de aceitação (Критерии приёмки)

• O instalador conclui sem erros.
• Login de administrador funciona.
• Criação de postes e grupos funciona no front-end.
• Backups executados com sucesso e certificados HTTPS em produção.

Resumo

Kliqqi é uma opção leve para criar comunidades sociais auto-hospedadas. A instalação no Ubuntu exige preparação do ambiente (Apache, PHP, MySQL), criação de banco e usuário, configuração do VirtualHost e execução do instalador via navegador. Após a instalação, aplique boas práticas de segurança e backups regulares.

Importante: mantenha seu servidor e software atualizados e teste atualizações em ambiente de staging antes de aplicar em produção.

Se você já usou outra plataforma melhor que o Kliqqi, compartilhe sua experiência nos comentários para ajudar outros administradores.