BookStack na VPS: wiki da empresa no seu servidor
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

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_URLseja 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_PASSWORDprecisa 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
TZdefine 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.
- Entre com
admin@admin.comepassword. - Troque a senha da conta.
- 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_KEYgerada com o comandoappkeye colada no Compose.APP_URLigual 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.comtrocado no primeiro acesso. - Pasta
/confige 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.