WikiJS

Sobre

Olá! Visitante, reunimos aqui informações sobre a instalação do Wiki.js, uma plataforma de gerenciamento de conhecimento de código aberto, que permite criar, editar e organizar conteúdo em uma interface web.

Sites Oficiais: https://wiki.js.org/

Vídeo

Carregar vídeo

YouTube

YouTube pode coligir dados pessoais. Politica de privacidade

ContinuarDispensar

https://youtu.be/EXEMPLO_VIDEO

Script Projeto Root

Para facilitar deixamos um script para fazer todo o processo de forma automatizada, assim agilizando o processo de instalação, caso queira utilizar faça:

Caso queira instalar manualmente veja abaixo os procedimentos

Aviso Importante

O processo de instalação remove completamente qualquer instalação anterior do Wiki.js, incluindo:

Banco de dados 'wikijs'
Usuário 'wikijsuser' do PostgreSQL
Pasta /opt/wikijs

Tenha total certeza que deseja prosseguir antes de continuar.

Preparação do Servidor

Sistema suportado: Debian 13

Atualizar o sistema:

sudo apt update && sudo apt upgrade -y

Instalar dependências essenciais:

sudo apt install curl wget gnupg2 unzip nano nginx postgresql postgresql-contrib -y

Remoção de versão Anterior

sudo -u postgres psql -tc "SELECT 1 FROM pg_database WHERE datname='wikijs'" | grep -q 1 && \
sudo -u postgres psql -c "DROP DATABASE wikijs;"
if sudo -u postgres psql -tc "SELECT 1 FROM pg_roles WHERE rolname='wikijsuser'" | grep -q 1; then
sudo -u postgres psql -c "REASSIGN OWNED BY wikijsuser TO postgres;"
sudo -u postgres psql -c "DROP OWNED BY wikijsuser;"
sudo -u postgres psql -c "DROP ROLE wikijsuser;"
fi
sudo rm -rf /opt/wikijs

Criação do Banco de Dados

Criar banco de dados e usuário do Wiki.js:(Mude 'SENHA_DO_BANCO' para uma senha segura!)

sudo -u postgres psql

CREATE DATABASE wikijs;
CREATE USER wikijsuser WITH PASSWORD 'SENHA_DO_BANCO';
GRANT ALL PRIVILEGES ON DATABASE wikijs TO wikijsuser;
\c wikijs
GRANT ALL PRIVILEGES ON SCHEMA public TO wikijsuser;
ALTER SCHEMA public OWNER TO wikijsuser;
\q

Instalação do Node.js

Instalar Node.js 20:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Verificar versão instalada:

node -v
npm -v

Download e Configuração do Wiki.js

Criar pasta de instalação:

sudo mkdir -p /opt/wikijs

Baixar última versão do Wiki.js e descompactar:

cd /opt/wikijs
wget https://github.com/Requarks/wiki/releases/download/VERSAO/wikijs.tar.gz
tar xzf wikijs.tar.gz
rm wikijs.tar.gz

Configuração do config.yml

Criar arquivo de configuração config.yml com os parâmetros do banco:

1. Backup do arquivo padrão de configuração do config.yml

cp /opt/wikijs/config.yml /opt/wikijs/config.yml.bkp 
rm  /opt/wikijs/config.yml

1. Faça um novo igual o trecho abaixo (Mude a SENHA_DO_BANCO para senha informada na criação do banco)

nano /opt/wikijs/config.yml

port: 3000
bindIP: 0.0.0.0
logLevel: info

db:
type: postgres
host: localhost
port: 5432
user: wikijsuser
pass: SENHA_DO_BANCO
db: wikijs
ssl: false

pool:
min: 2
max: 10

path:
data: ./data

uploads:
maxFileSize: 50mb

sessionSecret: 'wikijs-secret-key'

analytics:
enabled: false

auth:
local:
enabled: true

Ajustar permissões:

chmod 640 config.yml
sudo chown -R www-data:www-data /opt/wikijs

Serviço systemd

Criar arquivo de serviço systemd /etc/systemd/system/wikijs.service com os parâmetros necessários.

Comandos principais:

sudo systemctl daemon-reload
sudo systemctl enable wikijs
sudo systemctl start wikijs
sudo systemctl status wikijs

Configuração do Nginx

Criar configuração de proxy reverso /etc/nginx/sites-available/wikijs.conf:

nano /etc/nginx/sites-available/wikijs.conf

server {
listen 80;
server_name SEU_DOMINIO;

location / {  
    proxy_pass http://localhost:3000/;  
    proxy_http_version 1.1;  
    proxy_set_header Upgrade $http_upgrade;  
    proxy_set_header Connection 'upgrade';  
    proxy_set_header Host $host;  
    proxy_set_header X-Real-IP $remote_addr;  
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
    proxy_set_header X-Forwarded-Proto $scheme;  
}  


}

Ativar configuração e reiniciar Nginx:

sudo ln -sf /etc/nginx/sites-available/wikijs.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

HTTPS com Certbot (Opcional)

Instalar Certbot:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d SEU_DOMINIO

Finalização

Acesse no navegador:

http://SEU_DOMINIO ou http://IP_DO_SERVIDOR:3000

Complete a configuração inicial via interface web.