Perguntas Frequentes
Este documento reúne as dúvidas mais comuns dos usuários ao utilizar o ambiente local de desenvolvimento web ServBay, juntamente com suas respectivas respostas.
O que é o ServBay?
O ServBay é uma ferramenta integrada de gerenciamento de ambiente local para desenvolvimento web, projetada especialmente para simplificar o processo de configuração e administração de diferentes pacotes (como servidores web, bancos de dados e ambientes de linguagem de programação) no macOS. Para mais informações, consulte Sobre o ServBay.
Como instalar o ServBay?
Você pode baixar o instalador do ServBay diretamente do site oficial do ServBay e seguir o assistente de instalação. Para instruções detalhadas, acesse o documento Instalando o ServBay.
Como desinstalar o ServBay?
No macOS, basta arrastar o aplicativo ServBay para a “Lixeira” e, em seguida, esvaziá-la para concluir a desinstalação. Certifique-se de fazer backup dos dados importantes antes desse procedimento, pois todos os arquivos e configurações relacionados ao ServBay serão removidos. Consulte o documento Desinstalando o ServBay para mais detalhes.
O ServBay oferece atualização automática?
Sim, o ServBay possui uma função de atualização automática, facilitando a obtenção das versões mais recentes, novos recursos e correções de segurança. Veja mais no documento Atualizando o ServBay.
O ServBay é compatível com Windows/Linux?
Atualmente, o ServBay tem suporte principal ao macOS. O suporte para versões Windows e Linux está planejado para o futuro.
Quais idiomas são suportados pelo ServBay?
O ServBay oferece suporte a múltiplos idiomas de interface, incluindo inglês, chinês simplificado, chinês tradicional, espanhol, árabe, português, russo, japonês, alemão, francês, vietnamita, turco, italiano, entre outros. Você pode trocar facilmente o idioma nas configurações do ServBay. Para informações detalhadas sobre troca de idioma, consulte o documento Suporte a múltiplos idiomas.
Como realizar backup dos dados no ServBay?
O ServBay permite que você faça backup manual ou automático dos dados do ambiente de desenvolvimento, englobando configurações do ServBay, arquivos dos sites, conteúdo dos bancos de dados e certificados SSL. Além do backup manual da pasta de instalação /Applications/ServBay
, o ServBay oferece ferramentas internas para gerenciamento e restauração de backups, tornando este processo muito mais prático. Consulte Backup manual e automático de dados para detalhes.
Quais pacotes o ServBay oferece suporte?
O ServBay abrange diversos pacotes essenciais para desenvolvimento web, incluindo servidores web, bancos de dados, sistemas de cache, linguagens de programação e gerenciamento de múltiplas versões. Alguns dos principais pacotes suportados são: Caddy, NGINX, Apache, Mailpit, dnsmasq, múltiplas versões de PHP, Node.js, Python, Golang, Java, Ruby, Rust, .NET, MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Memcached e outros. Todos podem ser gerenciados facilmente pela interface do ServBay. Para mais informações de gerenciamento, acesse Gerenciamento de pacotes.
Como acessar as notas de lançamento do ServBay?
Você pode consultar detalhes sobre cada release na página Notas de Lançamento. As atualizações periódicas incluem novos recursos, melhorias e correções de bugs.
Posso executar várias versões do PHP ao mesmo tempo?
Sim, uma das grandes vantagens do ServBay é o suporte à instalação e execução simultânea de múltiplas versões do PHP. Você pode instalar e gerenciar diferentes versões do PHP pelo gerenciamento de pacotes e, ao criar ou configurar um site, escolher a versão necessária para cada projeto individualmente. Isso é ideal para quem precisa manter projetos com versões distintas de PHP. Para mais informações, consulte Adicionando o primeiro site e Como desenvolver usando PHP.
O ServBay é compatível com frameworks e CMS como Laravel, WordPress, etc.?
Sim, o ServBay oferece suporte total a frameworks PHP populares e sistemas de gerenciamento de conteúdo (CMS), incluindo Laravel, WordPress, Symfony, CodeIgniter, Joomla, Drupal, entre outros. É fácil configurar e executar essas aplicações localmente no ServBay. Veja os tutoriais em Como desenvolver usando PHP.
O ServBay suporta Vue, React, Next.js, Nuxt.js e outros frameworks e CMS?
Sim, o ServBay é compatível com os frameworks e bibliotecas JavaScript e TypeScript modernos baseados em Node.js, tais como Vue, React, Angular, Next.js, Nuxt.js, Express.js, Hapi.js, entre outros. Você pode gerenciar versões do Node.js e executar projetos front-end ou back-end JavaScript através do ServBay. Para tutoriais, acesse Como desenvolver usando Node.js.
Como adicionar um novo site?
Adicionar um site no ServBay é simples e direto. Através da interface gráfica, defina o diretório raiz do site, domínio, escolha o servidor web e as versões de PHP/Node.js desejadas. Consulte o documento Como adicionar o primeiro site para um passo a passo completo.
Como o ServBay gerencia domínios customizados e certificados SSL?
Para facilitar o desenvolvimento e testes locais, o ServBay oferece uma solução completa de rede local, incluindo um serviço de DNS local para resolução de domínios customizados (como servbay.demo
ou seuprojeto.servbay.demo
) e CA privadas integradas (ServBay User CA e ServBay Public CA). Essas autoridades certificadoras podem emitir certificados SSL confiáveis para seus sites locais, permitindo acesso via HTTPS e simulando ambientes de produção. Veja os detalhes em Adicionando sites com TLDs não padrão e Garantindo a segurança do site com SSL (HTTPS).
Posso usar domínios personalizados no ServBay?
Sim, o ServBay suporta amplamente o uso de domínios personalizados para desenvolvimento local, como .test
, .local
, .servbay.demo
, entre outros TLDs. Através do DNS local integrado, é possível configurar domínios únicos para cada site e acessá-los pelo navegador. Para orientações completas, consulte Adicionando sites com TLDs não padrão.
Como habilitar HTTPS em um site no ServBay?
Na interface de gerenciamento de sites do ServBay, você pode ativar facilmente o HTTPS para projetos locais. O ServBay oferece diversas opções para obter e configurar certificados SSL: usando a ServBay User CA ou ServBay Public CA para certificados locais confiáveis, solicitando certificados públicos via ACME (como Let's Encrypt ou ZeroSSL) para sites acessíveis publicamente, ou importando certificados já existentes. Saiba mais em Garantindo a segurança do site com SSL (HTTPS), Emitindo certificado SSL via ACME, Solicitando certificado do Let's Encrypt, Solicitando certificado do ZeroSSL, Solicitando certificado do Google Trust Services.
O ServBay suporta NGINX, Apache ou outros servidores web?
Sim, o ServBay integra os principais servidores web do mercado: Caddy, NGINX e Apache são fornecidos por padrão. Você pode escolher qualquer um desses servidores conforme as demandas do seu projeto. Confira Como definir o servidor web padrão para detalhes.
Quantos sites é possível criar no ServBay?
A quantidade de sites permitida depende da versão do ServBay:
- Na versão
ServBay Free
, é possível criar até 3 sites. - Usuários cadastrados (registro gratuito) podem criar até 5 sites.
- ServBay Pro e ServBay Team não possuem limite de sites. A adição e configuração dos sites é feita pela interface de gerenciamento.
Como gerenciar bancos de dados?
O ServBay oferece ferramentas práticas para gerenciar bancos MySQL, MariaDB, PostgreSQL e MongoDB. Possui integração direta com phpMyAdmin e Adminer, duas ferramentas web populares para administração de bancos. Acesse-os diretamente pela interface do ServBay. Para informações detalhadas de conexão e gerenciamento, veja o capítulo de "Gerenciamento de Banco de Dados".
Como utilizar a linha de comando?
O ServBay disponibiliza uma série de ferramentas de comandos, ideais para operações avançadas e tarefas automatizadas, como gerenciamento de pacotes, troca de ambientes e compilação de módulos PHP. O comando servbayctl
oferece controle flexível sobre o ambiente local. Para saber mais, consulte Suporte à linha de comando e Ferramenta de linha de comando servbayctl.
Como definir a versão padrão dos pacotes?
O ServBay permite definir versões padrão de pacotes como PHP, Python, Java, Go, Ruby, Rust, Node.js, MariaDB, PostgreSQL e outros para uso na linha de comando. Isto é útil para chamar diretamente comandos como php
, node
, mysql
no terminal, garantindo a versão desejada. Também é possível usar o arquivo .servbay.config
para definir versões padrão por projeto. Saiba mais em Definindo a versão padrão e Usando .servbay.config.
Posso personalizar o caminho de instalação de pacotes no ServBay?
Para manter o sistema organizado e simplificar a gestão, o ServBay instala todos os pacotes em uma estrutura de diretórios específica (principalmente em /Applications/ServBay
). Atualmente, não é possível personalizar o caminho de instalação dos pacotes.
O ServBay oferece suporte a múltiplos usuários e gerenciamento de permissões?
O ServBay é projetado principalmente para ambientes de desenvolvimento local de usuário único e não inclui gerenciamento tradicional de múltiplos usuários ou permissões detalhadas. Todos os serviços e sites do ServBay operam sob o ambiente do usuário atualmente conectado.
Como visualizar logs dos serviços no ServBay?
Através da interface gráfica do ServBay, você pode acessar facilmente os logs de cada serviço. No painel de gerenciamento de pacotes, clique no ícone de log ao lado do pacote desejado para abrir o respectivo arquivo de log. Isto é muito útil para diagnosticar falhas ao iniciar serviços ou problemas de execução. Saiba mais em Visualizando arquivos de log.
Como alterar configurações do PHP no ServBay?
Existem duas formas principais de modificar configurações do PHP no ServBay:
- Através da interface gráfica: O ServBay permite alterar diretamente a maioria dos parâmetros comuns do PHP pela interface, sendo a forma recomendada. Veja mais em Como alterar configurações do PHP.
- Editando o arquivo de configuração manualmente: Você pode editar o arquivo
php.ini
correspondente à versão do PHP em uso, localizado na pasta/Applications/ServBay/etc/php
. Após modificações, reinicie o serviço PHP desejado pelo ServBay para aplicar as alterações. Para detalhes, veja Visualizando arquivos de configuração.
Qual o usuário root e senha padrão do MySQL/MariaDB?
Durante a instalação, o ServBay define usuários root e senhas padrão para os bancos MySQL e MariaDB. Essas informações estão disponíveis na documentação específica de gerenciamento de banco. Consulte Usuário root, senha e informação de conexão para detalhes e instruções sobre redefinição de senha.
Qual o usuário root e senha padrão do PostgreSQL?
Da mesma forma que no MySQL/MariaDB, o ServBay define um usuário administrador e senha padrão durante a configuração inicial do PostgreSQL. Essas informações estão disponíveis na documentação de gerenciamento de banco. Veja Usuário root, senha e informação de conexão para mais detalhes, incluindo como redefinir a senha.
O ServBay permite usar diferentes versões de linguagens de desenvolvimento para projetos distintos?
Sim, o ServBay fornece uma poderosa capacidade de configuração de ambiente em nível de projeto. Basta adicionar um arquivo .servbay.config
na raiz do projeto para especificar versões independentes de PHP, Node.js, Python, Go, Java e outras linguagens, além de variáveis de ambiente para cada projeto. Por exemplo, é possível definir PHP 8.3 e Node.js 22 para o Projeto A, e PHP 8.1 junto com Node.js 18 para o Projeto B. Esse isolamento garante que diferentes projetos tenham ambientes próprios, aumentando a produtividade e a estabilidade do desenvolvimento.