Base de Conhecimento

BookStack na VPS: wiki da empresa no seu servidor

  • bookstack, docker, documentação, vps, mariadb
  • Usuários acharam útil: 0

Veja como instalar o BookStack numa VPS com Docker Compose e MariaDB: imagem da comunidade, APP_KEY, APP_URL, primeiro acesso, backup e como atualizar.

Por Redação Eleven Host · @robson.direitodigital · 2 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: BookStack na VPS: wiki da empresa no seu servidor

Capa da Redação Eleven Host para o guia: BookStack na VPS: wiki da empresa no seu servidor Arte: Eleven Host

BookStack na VPS é uma forma de ter a sua própria plataforma de documentação rodando num servidor que você controla. O README do projeto descreve o BookStack como uma plataforma para guardar e organizar informação e documentação, e este guia instala com Docker Compose.

Aqui você vê o que o BookStack é, o que a licença diz, o que a documentação pede de requisitos e como subir o sistema com um banco MariaDB. Depois, o primeiro acesso, o backup e a atualização. Se você ainda não conhece o servidor VPS, comece por O que é servidor VPS: guia simples para iniciantes. Os exemplos usam o endereço fictício 203.0.113.10.

Antes de começar: a imagem Docker é da comunidade

O BookStack não tem imagem Docker oficial. A página de instalação da documentação do BookStack diz que existem montagens Docker da comunidade para quem prefere uma versão em contêiner, e cita a LinuxServer.io e a solidnerd.

Este guia usa a imagem da LinuxServer.io, uma das duas indicadas pela documentação do BookStack. Os comandos e as variáveis vêm da página dessa imagem, e não do projeto BookStack. Por isso, quando o assunto for a imagem, vale consultar a documentação da LinuxServer.io.

Licença: o que o README diz

O README afirma que o código-fonte do BookStack é distribuído sob a licença MIT. As bibliotecas usadas e incluídas no BookStack seguem as próprias licenças e direitos autorais.

O código do BookStack está sob a licença MIT, e as bibliotecas que ele inclui têm licenças próprias.

Em caso de dúvida sobre uso comercial, consulte um profissional.

Requisitos segundo a documentação

Na instalação manual, a documentação pede PHP 8.2 ou superior, MySQL 8.0 ou superior (ou MariaDB 10.6 ou superior), Composer v2.2.0 ou superior, Git e um servidor web compatível com PHP.

Na imagem da LinuxServer.io, o PHP e o servidor web já vêm dentro do contêiner. O que você precisa fornecer é um banco MariaDB, que sobe como um segundo contêiner no mesmo Compose. A imagem existe para as arquiteturas x86-64 e arm64.

Você vai precisar de um servidor com Docker e Docker Compose instalados. Se você ainda não usou Docker numa VPS, veja o guia Gitea na VPS: seu servidor Git próprio com Docker, que também sobe um serviço com contêiner.

Está comparando planos de servidor? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Gerar a APP_KEY

O BookStack precisa de uma chave de aplicação, a APP_KEY. A página da imagem traz este comando, que roda um contêiner temporário só para gerar a chave:

docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey

Copie o valor que o comando mostrar. Ele vai na variável APP_KEY do Compose, no próximo passo.

Escrever o docker-compose.yml

A página da LinuxServer.io traz o Compose do BookStack, e a página da imagem MariaDB traz as variáveis do banco. Juntar os dois serviços num arquivo só é um exemplo de compose que montamos a partir dessas páginas, e nenhuma delas mostra o arquivo combinado.

Este exemplo usa a forma com chaves do YAML, em que o recuo das linhas não importa. Assim você copia e cola sem se preocupar com espaços. Crie o arquivo docker-compose.yml numa pasta do servidor e troque os valores de exemplo:

services: {

bookstack: {

image: lscr.io/linuxserver/bookstack:latest,

container_name: bookstack,

environment: [PUID=1000, PGID=1000, TZ=Etc/UTC,

APP_URL=http://203.0.113.10:6875,

APP_KEY=cole-aqui-a-chave-gerada,

DB_HOST=mariadb, DB_PORT=3306,

DB_USERNAME=bookstack,

DB_PASSWORD=troque-esta-senha,

DB_DATABASE=bookstackapp],

volumes: [/opt/bookstack/config:/config],

ports: [6875:80],

depends_on: [mariadb],

restart: unless-stopped},

mariadb: {

image: lscr.io/linuxserver/mariadb:latest,

container_name: mariadb,

environment: [PUID=1000, PGID=1000, TZ=Etc/UTC,

MYSQL_ROOT_PASSWORD=troque-a-senha-root,

MYSQL_DATABASE=bookstackapp,

MYSQL_USER=bookstack,

MYSQL_PASSWORD=troque-esta-senha],

volumes: [/opt/mariadb/config:/config],

restart: unless-stopped}}

Alguns pontos para conferir no arquivo:

  • APP_URL: é obrigatória e leva o protocolo, o endereço e a porta pelos quais você acessa o BookStack. Se você colocar um proxy na frente, a documentação da imagem pede que a APP_URL seja o endereço externo, senão o app não funciona direito.
  • DB_HOST: aqui é mariadb, o nome do serviço do banco no Compose.
  • Usuário, senha e banco: têm de ser os mesmos nos dois serviços. A DB_PASSWORD precisa de pelo menos 4 caracteres, e caracteres que não são letras ou números exigem escape.
  • Porta 3306: o exemplo não publica a porta do banco. O BookStack acessa o banco pela rede do Compose.
  • PUID e PGID: o padrão é 1000. O TZ define o fuso horário.

A pasta /config de cada contêiner fica mapeada numa pasta do servidor. É nela que ficam os dados, e é isso que permite atualizar a imagem sem perdê-los.

Subir o BookStack

Com o arquivo pronto, suba os dois contêineres e confira o estado deles:

docker compose up -d

docker compose ps

Se algo falhar, um exemplo de comando para ver os registros é docker compose logs bookstack. Confira também se a senha e o nome do banco são iguais nos dois serviços.

Depois, abra o endereço que você colocou na APP_URL. No exemplo, http://203.0.113.10:6875. Se a página abrir mas os links ou o login falharem, uma possível causa é uma APP_URL diferente do endereço que você digitou no navegador. Para um guia sobre outro serviço que roda com Docker nesta mesma lógica, veja NocoDB na VPS: como instalar com Docker.

Primeiro acesso: troque a senha padrão

O login padrão do BookStack é admin@admin.com e a senha é password. A documentação manda alterar esses dados logo depois de entrar pela primeira vez. Como a página fica acessível pelo endereço da APP_URL, faça isso antes de compartilhar o endereço com alguém.

  1. Entre com admin@admin.com e password.
  2. Troque a senha da conta.
  3. Troque também o e-mail da conta, para um que seja seu.

Backup do BookStack

A documentação de backup do BookStack diz que há dois tipos de conteúdo para guardar: arquivos e registros do banco de dados.

Entre os arquivos, a documentação cita o .env, a pasta public/uploads, a pasta storage/uploads e a pasta themes. Na imagem da LinuxServer.io, o volume /config fica mapeado numa pasta do servidor. Copie essa pasta para outro lugar e confira nela se estão o .env e as pastas de uploads e temas.

Para o banco, a documentação mostra o mysqldump neste formato, com o usuário e o nome do banco no lugar das chaves:

mysqldump -u {mysql_user} -p {database_name} > {output_file_name}

Como o banco roda dentro do contêiner, um exemplo é executar o mysqldump dentro do contêiner mariadb com docker exec. Esse atalho é nosso, e não está na documentação.

Na hora de restaurar, a documentação dá um aviso para quem usa Docker: restaure o banco antes de subir o contêiner do BookStack. Guarde também a APP_KEY, que está no seu docker-compose.yml.

Atualizar a imagem

Segundo a página da LinuxServer.io, a atualização é baixar a imagem nova e recriar o contêiner. Como a pasta /config está mapeada no servidor, ela continua lá:

docker compose pull

docker compose up -d

Na página de releases do BookStack no GitHub, a versão v26.09.2 aparece com a data de 20 de outubro. O Docker Hub lista a tag latest e também tags de versão, como 26.09.2. Para fixar uma versão, troque o latest no Compose pela tag que você escolher. Faça o backup antes de atualizar.

Checklist do BookStack na VPS

  • Imagem da comunidade (LinuxServer.io) e MariaDB como segundo serviço.
  • APP_KEY gerada com o comando appkey e colada no Compose.
  • APP_URL igual ao endereço que você usa no navegador.
  • Usuário, senha e nome do banco iguais nos dois serviços; porta 3306 sem publicar.
  • Login admin@admin.com trocado no primeiro acesso.
  • Pasta /config e dump do banco guardados fora do servidor.
  • Banco restaurado antes de subir o BookStack, se for recuperar um backup.

Vai escolher onde instalar? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Perguntas frequentes

O BookStack tem imagem Docker oficial?

Não. A documentação do BookStack aponta imagens da comunidade, como a da LinuxServer.io, que é a usada neste guia.

Qual é o login e a senha padrão do BookStack?

O login é admin@admin.com e a senha é password. A documentação manda trocar esses dados logo após o primeiro acesso.

O BookStack precisa de um banco de dados?

Sim. A documentação pede MySQL 8.0 ou superior, ou MariaDB 10.6 ou superior. Neste guia, o MariaDB sobe como um segundo contêiner no Compose.

O que é preciso guardar no backup?

Os arquivos (como o .env e as pastas de uploads e temas) e os registros do banco, que a documentação manda copiar com o mysqldump. Na imagem da LinuxServer.io, o volume /config é a pasta mapeada no servidor.

Qual é a licença do BookStack?

O README diz que o código-fonte está sob a licença MIT. Em caso de dúvida sobre uso comercial, consulte um profissional.

Esta resposta lhe foi útil?

Artigos Relacionados