"VT-x is disabled" / "AMD-V is disabled": ative a virtualização na BIOS (passo 2). "Physical network interface not found": abra Settings → Network e escolha de novo a sua placa de rede em Name (passo 4). Falta memória: feche outros programas para o computador ter 8 GB de RAM livres para a VM. O RepairAmigo precisa de 8 GB (8192 MB); não diminua. Mac: confira se é um Mac com Intel. Apple Silicon não é compatível. Linux, "kernel driver not installed": reinstale o VirtualBox; com Secure Boot, assine ou libere os módulos de kernel.

Instale o RepairAmigo passo a passo.

Q: Não consigo abrir o RepairAmigo em outro computador

Confira se o Adapter 1 está em Bridged Adapter e não em NAT (passo 4). Os dois aparelhos precisam estar na mesma rede da loja, e não numa rede Wi-Fi de visitantes. Digite o endereço completo, com http://, por exemplo http://192.168.1.50/. O IP pode ter mudado: olhe de novo a tela da VM e crie uma reserva de DHCP (passo 6). Se estiver no Wi-Fi, teste com cabo. Desligue qualquer VPN no aparelho que você está usando.

O RepairAmigo funciona como uma máquina virtual (VM) num computador da sua loja, com o VirtualBox, que é gratuito. Este guia leva você do zero até a primeira entrada de aparelho, com telas reais.

Baixar o VirtualBox
Instalar o VirtualBox
Importar o RepairAmigo
Conectar à rede da loja
Ligar e desligar a VM
Achar o endereço IP
Usar o RepairAmigo
Solução de problemas

1. Baixar o VirtualBox

O VirtualBox é um programa gratuito e de código aberto para rodar máquinas virtuais. Ele é instalado uma vez só, no computador onde o RepairAmigo vai rodar. Escolha um computador que fique ligado durante todo o horário da loja.

Requisitos: 8 CPUs e 8 GB de RAM para a máquina virtual do RepairAmigo, num computador de 64 bits com processador Intel ou AMD. O ideal é ligar esse computador na rede da loja por cabo.

Abra a página oficial de downloads: virtualbox.org/wiki/Downloads (a página está em inglês).
Em VirtualBox Platform Packages, clique no pacote do seu computador:

Seu computador	Clique em	Você recebe
Windows 10 / 11	Windows hosts	um instalador `.exe`
Mac com processador Intel	macOS / Intel hosts	uma imagem de disco `.dmg`
Linux (Ubuntu, Debian, Fedora…)	Linux distributions, depois sua distribuição e versão	um pacote `.deb` ou `.rpm`

O Extension Pack da mesma página é opcional. O RepairAmigo não precisa dele, e ele tem uma licença à parte; só baixe se souber que precisa.

Mac com Apple Silicon (M1, M2, M3, M4)? Não é compatível. A VM do RepairAmigo é feita para processadores Intel/AMD (x86-64) e não roda em Mac com Apple Silicon, nem com o pacote "macOS / Apple Silicon hosts". Use um PC com Windows ou Linux, ou um Mac com Intel.

Legenda: A página de downloads do VirtualBox. Escolha seu pacote em "VirtualBox Platform Packages".

2. Instalar o VirtualBox

O VirtualBox pode aparecer em inglês ou em português, dependendo do seu sistema. Abaixo usamos os nomes em inglês, como nas imagens.

Windows

Dê dois cliques no arquivo baixado (algo como VirtualBox-7.x.x-…-Win.exe). Se o Windows perguntar "Deseja permitir que este aplicativo faça alterações no seu dispositivo?", clique em Sim.
Na tela de boas-vindas, clique em Next.
Em Custom Setup, deixe marcados os recursos que já vêm marcados e clique em Next.
Um aviso de Network Interfaces informa que a rede vai cair por um instante. Salve o que estiver fazendo e clique em Yes.
Se aparecer Missing Dependencies (Python Core / win32api), clique em Yes para continuar. O RepairAmigo não precisa disso.
Clique em Install. Quando o Windows pedir para instalar software de dispositivo da Oracle, clique em Instalar todas as vezes.
Clique em Finish. O VirtualBox Manager vai abrir.

Se o instalador disser que falta o Microsoft Visual C++ Redistributable, instale a versão x64 mais recente pelo site da Microsoft e rode de novo o instalador do VirtualBox.

macOS (só Intel)

Abra o .dmg, dê dois cliques em VirtualBox.pkg e siga o instalador. Se o macOS bloquear a instalação, abra Ajustes do Sistema → Privacidade e Segurança, clique em Permitir ao lado da mensagem da Oracle e rode o instalador de novo.

Linux

Instale o pacote baixado. Por exemplo, no Ubuntu/Debian:

sudo apt install ./virtualbox-7.*.deb sudo usermod -aG vboxusers $USER

Saia da sessão e entre de novo depois do segundo comando. Se o computador usa Secure Boot, o instalador pode pedir para assinar os módulos de kernel do VirtualBox.

Ative a virtualização na BIOS (VT-x / AMD-V)

A maioria dos computadores já vem com ela ativada. Se depois o VirtualBox mostrar "VT-x is disabled in the BIOS" ou "AMD-V is disabled":

Reinicie o computador e entre na configuração da BIOS/UEFI (normalmente apertando Del, F2, F10 ou Esc logo ao ligar).
Procure Intel Virtualization Technology (VT-x) ou SVM Mode (AMD-V), geralmente em Advanced, CPU Configuration ou Security, e coloque em Enabled.
Salve e saia (muitas vezes com F10).

Legenda: O VirtualBox Manager depois de instalado. Sua versão pode ser mais nova.

3. Importar a máquina virtual do RepairAmigo

O RepairAmigo vem num único arquivo, RepairAmigo.ova, que você importa no VirtualBox.

Abra o VirtualBox e clique em File → Import Appliance… (Arquivo → Importar Appliance), ou aperte Ctrl+I.
Deixe Source em Local File System. Clique no ícone de pasta ao lado de File, escolha o RepairAmigo.ova (normalmente na pasta Downloads) e clique em Next.
Confira as Appliance settings: - RAM: 8192 MB (8 GB). Dê dois cliques no valor para mudar. - CPU: 8. Dê dois cliques no valor para mudar. - MAC Address Policy: Generate new MAC addresses for all network adapters (gerar endereços MAC novos). - Deixe marcado Import hard drives as VDI.
Clique em Finish (nas versões mais antigas, Import) e espere a barra de progresso terminar. Pode levar alguns minutos.
O RepairAmigo agora aparece na lista à esquerda.

Para mudar a memória ou os processadores depois, desligue a VM, selecione-a, clique em Settings → System e ajuste Base Memory (e a aba Processor).

Legenda: Settings: Base Memory em 8192 MB (8 GB). Na aba Processor, coloque 8 CPUs.

4. Conectar à rede da loja (modo bridge)

Por quê: de fábrica, o VirtualBox esconde a VM atrás do seu computador (NAT), e os outros computadores, tablets e celulares da loja não conseguem acessá-la. Com o Bridged Adapter (placa em modo bridge), a VM entra na rede da loja como qualquer outro computador e recebe do roteador o seu próprio endereço IP. Assim, todos os aparelhos da loja conseguem abrir o RepairAmigo.

Confira se a VM está desligada. Selecione o RepairAmigo e clique em Settings.
Clique em Network. Em Adapter 1, marque Enable Network Adapter.
Em Attached to, escolha Bridged Adapter.
Em Name, escolha a placa de rede que este computador usa na rede da loja: a placa Ethernet (recomendado) ou a de Wi-Fi. No Windows, o nome costuma ser algo como "Intel(R) Ethernet…" ou "Realtek PCIe GbE…".
Clique em OK.

Legenda: Network → Adapter 1 → Bridged Adapter. O nome da placa vai ser diferente no seu computador.

Dica: se der, use cabo de rede. Algumas redes Wi-Fi (rede de visitantes, alguns sistemas mesh) não aceitam VM em modo bridge.

5. Ligar e desligar a VM

Selecione o RepairAmigo e clique na setinha ao lado de Start: - Normal Start abre uma janela com a tela da VM. Use na primeira vez, para ver o endereço IP. - Headless Start roda a VM em segundo plano, sem janela. Ideal para o dia a dia.
Espere de 1 a 2 minutos, até a tela da VM mostrar o cabeçalho do RepairAmigo com o endereço que você deve abrir, por exemplo http://192.168.1.50/, e logo abaixo um aviso de login. Não precisa fazer login ali: abra esse endereço no navegador de qualquer computador da loja (passo 7).
Para desligar, clique com o botão direito na VM e escolha Stop → ACPI Shutdown (na janela da VM: Machine → ACPI Shutdown). Assim o banco de dados fecha do jeito certo.

Evite "Power Off". É como tirar da tomada e pode corromper o banco de dados. Se fechar a janela da VM, escolha Send the shutdown signal, e não Power off the machine. Sempre desligue a VM antes de reiniciar ou desligar o computador.

Ligar o RepairAmigo automaticamente

Windows: crie um arquivo chamado RepairAmigo.bat com a linha abaixo e coloque na pasta Inicializar (aperte Win+R, digite shell:startup e aperte Enter).

"C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" startvm "RepairAmigo" --type headless

Linux: adicione @reboot VBoxManage startvm "RepairAmigo" --type headless ao crontab do seu usuário (crontab -e).
macOS: rode o mesmo comando VBoxManage startvm como item de início de sessão.
Desative a suspensão do computador (Windows: Configurações → Sistema → Energia → Suspender: Nunca). Se o computador entrar em suspensão, o RepairAmigo para para todo mundo.

6. Achar o endereço IP da VM

Olhe a tela da VM. Quando a VM liga, a tela mostra o endereço IP no cabeçalho do RepairAmigo, por exemplo Repair Amigo - abra http://192.168.1.50/ no seu navegador. Digite http://<endereço-IP>/ no navegador de qualquer computador, tablet ou celular da mesma rede para abrir o RepairAmigo. Se usou Headless Start, clique com o botão direito na VM e escolha Show.
Ou confira no roteador. Abra a página de administração do roteador e procure a lista de clientes DHCP (também chamada de dispositivos conectados). Procure um dispositivo chamado repairamigo ou um endereço MAC que comece com 08:00:27 (VirtualBox).

Recomendado: reserve o endereço. No roteador, crie uma reserva de DHCP (também chamada de IP fixo) para o endereço MAC da VM. Assim o IP nunca muda e os favoritos dos aparelhos da loja continuam funcionando. Para ver o MAC da VM: Settings → Network, mude para Expert no canto superior esquerdo e abra Advanced → MAC Address.

7. Usar o RepairAmigo

O RepairAmigo é usado pelo navegador de qualquer computador, tablet ou celular conectado à mesma rede da loja. Tudo, inclusive os seus dados, é feito dentro do sistema.

Primeira vez: configuração inicial e conta de Dono

Em qualquer aparelho da loja, abra http://<endereço-IP>/, por exemplo http://192.168.1.50/. Na primeira vez, abre a tela de Configuração inicial.
Digite o nome da loja e o fuso horário e crie a conta de Dono com a senha.
Guarde bem a senha de Dono. É a conta com mais permissões: cuida dos usuários, das configurações e dos seus dados.

Legenda: Configuração inicial: dados da loja e conta de Dono (dados de demonstração).

No dia a dia: entrar

Abra http://<endereço-IP>/ e entre com o seu usuário.
Salve nos favoritos (ou use "Adicionar à tela de início" no celular ou tablet) em cada aparelho da loja.
O Dono pode cadastrar Gerentes e Técnicos pelo menu Administração.

Legenda: O menu principal do RepairAmigo (dados de demonstração).

Seus dados: exportar e importar

Só o Dono pode fazer isso. Vá em Menu principal → Administração → Só o dono.

Exportar dados permite baixar:

Backup SQL (.sql.gz): o banco de dados inteiro. Bom para guardar.
Tabelas em CSV (.zip): um arquivo de planilha por tabela, para abrir no Excel.
Pacote de migração (.ramig, criptografado): tudo o que é preciso para levar sua loja para uma versão nova do RepairAmigo ou para outro computador. Você escolhe uma frase-senha.

Por segurança, as exportações SQL e CSV não incluem os hashes das senhas dos usuários nem as credenciais de SMS (Twilio).

Guarde bem a frase-senha. Um pacote de migração não abre sem ela, e ninguém, nem o RepairAmigo, consegue recuperá-la.

Importar dados carrega um pacote de migração (.ramig) e substitui todos os dados deste RepairAmigo:

Escolha o arquivo .ramig e digite a frase-senha e a sua senha de Dono.
Deixe marcado Só verificar e clique em Importar primeiro. Assim o pacote é testado sem mudar nada.
Para substituir os dados de verdade, desmarque Só verificar, digite IMPORT e clique em Importar. Antes disso, o sistema faz um backup de segurança dos dados atuais, e Restaurar anterior traz tudo de volta se precisar.

Você não precisa de ferramenta de banco de dados. O RepairAmigo não inclui phpMyAdmin nem acesso direto ao banco. Tudo é feito dentro do sistema, e os seus dados sempre podem ser exportados.

Precisa de ajuda?

Use Solicitar suporte dentro do RepairAmigo (Administração → Configurações → Suporte). O Dono ou um Gerente escreve a mensagem, e as respostas do RepairAmigo aparecem na mesma página. Você também pode escrever para support@repairamigo.com. Nunca envie dados de clientes nem senhas.

8. Solução de problemas e perguntas frequentes

A VM não liga

"VT-x is disabled" / "AMD-V is disabled": ative a virtualização na BIOS (passo 2).
"Physical network interface not found": abra Settings → Network e escolha de novo a sua placa de rede em Name (passo 4).
Falta memória: feche outros programas para o computador ter 8 GB de RAM livres para a VM. O RepairAmigo precisa de 8 GB (8192 MB); não diminua.
Mac: confira se é um Mac com Intel. Apple Silicon não é compatível.
Linux, "kernel driver not installed": reinstale o VirtualBox; com Secure Boot, assine ou libere os módulos de kernel.

Não consigo abrir o RepairAmigo em outro computador

Confira se o Adapter 1 está em Bridged Adapter e não em NAT (passo 4).
Os dois aparelhos precisam estar na mesma rede da loja, e não numa rede Wi-Fi de visitantes.
Digite o endereço completo, com http://, por exemplo http://192.168.1.50/.
O IP pode ter mudado: olhe de novo a tela da VM e crie uma reserva de DHCP (passo 6).
Se estiver no Wi-Fi, teste com cabo. Desligue qualquer VPN no aparelho que você está usando.

Esqueci a senha de Dono

Por segurança, a senha de Dono não pode ser redefinida por este site. Peça para um Gerente entrar e mandar uma mensagem em Solicitar suporte (Administração → Configurações → Suporte); a resposta do RepairAmigo aparece nessa página. Se um funcionário esqueceu a senha, ele deve pedir ajuda ao Dono ou a um Gerente.

O RepairAmigo está lento

Confira se a VM tem 8 CPUs e 8192 MB (8 GB) de memória (VM desligada → Settings → System).
Deixe memória livre no computador e feche programas pesados.
Guarde a VM num SSD, e não num HD mecânico.
No Windows, uma tartaruga verde na janela da VM quer dizer que o Hyper-V está deixando o VirtualBox lento. Desativar o Hyper-V e a Plataforma de Máquina Virtual em "Ativar ou desativar recursos do Windows" normalmente resolve.
Ligue o computador na rede por cabo.

Preciso deixar o VirtualBox aberto?

Não. Com Headless Start, a VM continua rodando em segundo plano mesmo se você fechar o VirtualBox Manager. O computador precisa ficar ligado e sem entrar em suspensão.

Como faço backup?

Exporte seus dados com frequência (passo 7) e guarde cópias em outro lugar, como um pendrive ou um segundo computador. Antes de apagar uma VM, exporte sempre primeiro: apagar a VM apaga os dados que estão dentro dela.

O RepairAmigo é gratuito mesmo?

Sim. O RepairAmigo é grátis para baixar e usar: sem mensalidade, sem cartão de crédito e sem cobrança por OS.

Tem limite de ordens de serviço ou de usuários?

Não. Não há limite de OS nem de usuários. É uma instalação por loja.

O RepairAmigo funciona na nuvem?

Não. Ele roda num computador da sua loja e a equipe abre pelo navegador, dentro da rede da loja. Os registros de consertos, clientes e estoque ficam guardados no seu próprio computador, e o Dono pode exportá-los quando quiser.

Tem aplicativo para celular?

Não há aplicativo nas lojas de apps. Qualquer celular ou tablet conectado à rede da loja abre o RepairAmigo pelo navegador, com as mesmas regras e preços, e você pode adicioná-lo à tela de início.

O sistema está em português?

Sim. Existe uma edição do RepairAmigo em português do Brasil, com o sistema todo em português. É uma edição separada das versões em inglês e espanhol, e não uma troca de idioma dentro do sistema. Baixe a edição em português na página de download.

Manda mensagem pelo WhatsApp?

Não. Os avisos para o cliente são opcionais e saem por SMS, só de ida, pela conta Twilio da própria loja. A loja paga as mensagens direto à Twilio, e o envio precisa de internet. Vem desativado de fábrica.

Emite nota fiscal?

Não. O RepairAmigo não emite NF-e nem NFC-e. Use o emissor de nota fiscal que você já usa junto com ele.

Aceita pagamento com cartão ou Pix?

O RepairAmigo não processa pagamentos. A tela de venda em dinheiro (POS) e o controle de caixa registram o dinheiro que entra e sai da loja.

Ainda com dúvidas?

Leia os guias ou escreva para support@repairamigo.com.