Como Hospedar Self-Host BookStack em um VPS (Guia Completo)

BookStack é uma plataforma simples e self-hosted para organizar e armazenar documentação. Se você é um desenvolvedor ou um homelabber procurando hospedar o BookStack em um VPS, este guia irá te conduzir pelo processo de instalação passo a passo. Exploraremos a instalação usando Docker, que torna a implantação e gestão de aplicações mais fácil.

Por que usar o BookStack?

O BookStack permite criar documentação estilo wiki com facilidade, com recursos como:

• Páginas aninhadas
• Suporte a Markdown
• Funções e permissões de usuários
• Recursos de busca integrados

Isso torna o BookStack uma escolha ideal para quem deseja construir e manter documentação para projetos ou uso pessoal.

Escolhendo um Provedor de VPS

Existem diversos provedores de VPS para escolher, dependendo do seu orçamento e requisitos. Abaixo, uma comparação rápida dos provedores mais populares:

Ao escolher um provedor de VPS, considere fatores como preço, desempenho e facilidade de uso. Se estiver em dúvida, confira nossa comparação completa de VPS para mais opções.

Preparando seu VPS

1. Implante seu VPS: Escolha um provedor da tabela e configure seu VPS. Selecione sua distribuição Linux preferida (Ubuntu/Debian é recomendado).

2. Acesse seu servidor: Use SSH para conectar ao seu servidor. Você pode usar um aplicativo de terminal como PuTTY ou o terminal do seu sistema.

   ssh nome_de_usuário@ip_do_seu_vps

3. Atualize seu sistema: Mantenha seu sistema sempre atualizado.

   sudo apt update && sudo apt upgrade -y

Instalando Docker

O BookStack pode ser facilmente executado usando Docker. Instale o Docker executando os comandos abaixo:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Você pode verificar a instalação consultando a versão do Docker:

docker --version

Instalando Docker Compose

O Docker Compose é uma ferramenta para definir e rodar aplicações Docker com múltiplos contêineres. Instale o Docker Compose com os seguintes comandos:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Verifique se o Docker Compose foi instalado corretamente:

docker-compose --version

Implantando o BookStack

1. Crie um diretório para o BookStack:

mkdir ~/bookstack
cd ~/bookstack

2. Crie um arquivo docker-compose.yml:

Use seu editor de texto preferido para criar o arquivo:

nano docker-compose.yml

Adicione a seguinte configuração:

version: '2'
services:
  bookstack:
    image: solidnerd/bookstack
    ports:
      - "80:80"
    environment:
      - DB_HOST=db
      - DB_USER=bookstack
      - DB_PASS=bookstackpassword
      - DB_DATABASE=bookstack
    depends_on:
      - db

  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=bookstack
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=bookstackpassword
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

Modifique as senhas do banco de dados conforme necessário.

3. Inicie os containers:

Execute o comando abaixo para iniciar o BookStack:

docker-compose up -d

Este comando fará o download das imagens necessárias e as iniciará em modo detached.

4. Acesse o BookStack:

Abra seu navegador e acesse http://seu_ip_vps. Você deverá ver a página de configuração do BookStack. Siga as instruções na tela para concluir a instalação.

Gerenciando o BookStack

Você pode gerenciar o BookStack através da interface web. É possível adicionar usuários, criar diferentes livros, capítulos e páginas conforme suas necessidades.

Perguntas Frequentes

Q1: Posso rodar o BookStack sem Docker?

Sim, você pode instalar o BookStack sem Docker, mas isso exige configuração manual mais detalhada, incluindo PHP, MariaDB e um servidor web como Apache ou Nginx. O Docker simplifica bastante o processo, facilitando a implantação e atualizações.

Q2: Como faço backup da minha instalação do BookStack?

Para fazer backup, será necessário copiar os dados do banco de dados e os arquivos da aplicação. Você pode usar comandos Docker para copiar os arquivos do banco e salvar os dados do seu diretório do BookStack. Automatizar esse processo com scripts pode facilitar ainda mais seus backups.

Q3: O BookStack é seguro para autohospedagem?

O BookStack é relativamente seguro, especialmente quando autohospedado. É fundamental usar senhas fortes, manter o software atualizado e configurar regras de firewall adequadas. Além disso, usar SSL (via Let’s Encrypt ou similar) ajuda a garantir acesso seguro ao seu BookStack pela web.

Conclusão

Hospedar o BookStack em um VPS oferece uma maneira poderosa de gerenciar sua documentação. Com os passos deste guia, você pode implantar e gerenciar sua própria instância de forma eficiente. Não deixe de explorar os diversos recursos do BookStack e personalizá-lo conforme suas necessidades conforme sua base de conhecimento cresce. Para outras opções e comparações de provedores de VPS, confira nossa comparação completa de VPS. Boa hospedagem!