Aviso: esta configuração tem uma etapa técnica
Você vai precisar usar algo chamado "SSH" para executar alguns comandos.
Nós sabemos, gostaríamos de poder pular esta parte também. Mas seu dispositivo não nos dá uma opção mais simples. A boa notícia: é só copiar e colar. Se você consegue seguir instruções, você consegue fazer isso.
O fabricante da sua impressora não oferece uma forma mais simples de plataformas como o SimplyPrint se conectarem. O SSH é como contornamos essa limitação para te dar os recursos que você precisa.
Você vai executar alguns comandos que fornecemos, basicamente só copiar e colar. Não é necessário programar.
O que este guia faz
A instalação do Moonraker da sua impressora está desatualizada ou usa uma versão modificada pelo fabricante que não inclui suporte ao SimplyPrint.
Este guia usa um script para instalar uma instância nova e atualizada do Moonraker com o SimplyPrint integrado, ao lado da sua configuração existente. Sua configuração do Klipper não é modificada.
Você consegue acessar o Mainsail ou o Fluidd?
Se você consegue acessar a interface web da sua impressora (Mainsail ou Fluidd) e não consegue entrar via SSH, tente a configuração normal do Klipper em vez disso, sua impressora pode funcionar com a configuração padrão. Não temos 100% de certeza de que todas as impressoras listadas aqui têm o problema da Makerbase; algumas podem funcionar bem com o método normal.
Use por sua conta e risco: este script foi testado em muitas impressoras e instala uma instância separada do Moonraker ao lado da sua configuração existente, sem modificar sua configuração do Klipper ou o firmware. No entanto, qualquer modificação no software da sua impressora carrega algum risco. Não podemos garantir compatibilidade com todas as impressoras ou configurações, e não nos responsabilizamos por quaisquer problemas que possam surgir. Se algo der errado, geralmente você pode remover os arquivos instalados e reiniciar a impressora para voltar ao estado original.
1. Encontre o endereço IP da sua impressora
Você precisa saber o endereço IP da sua impressora para se conectar a ela.
Buscar o endereço IP
- O endereço IP geralmente aparece na tela da sua impressora ou nas configurações de rede dela
- Não encontrou? Verifique as configurações do seu roteador para ver os dispositivos conectados
- Ou use uma ferramenta de escaneamento de rede como o Angry IP Scanner
2. Conecte-se via SSH
O SSH permite executar comandos no computador integrado da sua impressora.
Sim, esta é a parte técnica chata. Sentimos muito — tentamos de tudo para evitar isso, mas seu dispositivo simplesmente não nos dá outra opção.
Mas aqui está o segredo: é mais fácil do que parece. Você só vai copiar e colar alguns comandos. Só isso. Escolha o tipo do seu computador abaixo e siga os passos — vamos te guiar em cada clique.
192.168.1.42). Não inclua http://, barras ou números de porta.
Windows 10 / 11
- Pressione Win + X e selecione "Terminal" ou "PowerShell"
-
Digite o comando SSH (substitua os espaços reservados):
Exemplo:
ssh username@ip-addressssh [email protected] -
Se for perguntado "Are you sure you want to continue connecting?", digite
yese pressione Enter -
Digite a senha quando solicitado
A senha não vai aparecer enquanto você digita — isso é normal! Só digite e pressione Enter.
macOS
- Pressione Cmd + Space para abrir o Spotlight, digite "Terminal" e pressione Enter
-
Digite o comando SSH (substitua os espaços reservados):
Exemplo:
ssh username@ip-addressssh [email protected] -
Se for perguntado "Are you sure you want to continue connecting?", digite
yese pressione Enter -
Digite a senha quando solicitado
A senha não vai aparecer enquanto você digita — isso é normal! Só digite e pressione Enter.
Linux
- Abra o Terminal (geralmente Ctrl + Alt + T, ou encontre-o no menu de aplicativos)
-
Digite o comando SSH (substitua os espaços reservados):
Exemplo:
ssh username@ip-addressssh [email protected] -
Se for perguntado "Are you sure you want to continue connecting?", digite
yese pressione Enter -
Digite a senha quando solicitado
A senha não vai aparecer enquanto você digita — isso é normal! Só digite e pressione Enter.
Chromebook
-
Ative o Linux (pule esta etapa se já tiver feito isso):
- Abra Configurações
- Acesse Avançado → Desenvolvedores
- Ative "Linux development environment"
- Siga o assistente de configuração (leva alguns minutos)
- Abra o aplicativo "Terminal" no seu menu de aplicativos
-
Digite o comando SSH (substitua os espaços reservados):
Exemplo:
ssh username@ip-addressssh [email protected] -
Se for perguntado "Are you sure you want to continue connecting?", digite
yese pressione Enter -
Digite a senha quando solicitado
A senha não vai aparecer enquanto você digita — isso é normal! Só digite e pressione Enter.
Problemas comuns
- "Connection refused" — certifique-se de estar na mesma rede e de que o endereço IP está correto.
- "Permission denied" — verifique novamente seu nome de usuário e senha.
-
"Host key verification failed" — o dispositivo foi redefinido ou reinstalado. Remova a chave antiga com:
ssh-keygen -R <ip-address>
Está usando um tablet ou celular?
Embora existam apps de SSH disponíveis para Android e iOS, recomendamos usar um computador para conexões SSH. Um teclado e uma tela adequados tornam a digitação de comandos muito mais fácil.
Depois de abrir o terminal, conecte-se à sua impressora:
ssh mks@YOUR_IP_ADDRESS
Substitua YOUR_IP_ADDRESS pelo endereço IP da sua impressora, por exemplo ssh [email protected]
Quando for solicitada uma senha, digite makerbase e pressione Enter. A senha não aparece enquanto você digita, isso é normal.
3. Corrija a data se encontrar erros de SSL
Erro de certificado SSL?
A maioria das impressoras com Makerbase, especialmente os modelos Qidi Tech, têm o relógio do sistema configurado incorretamente. Isso causa erros de certificado SSL ao baixar arquivos.
Se você vir um erro como ERROR: The certificate of 'download.simplyprint.io' is not trusted, execute primeiro este comando:
sudo date -s '2026-10-27'
Copie e cole o comando acima, ele já contém a data de hoje. Você pode ser solicitado a informar uma senha, use makerbase.
4. Instale o SimplyPrint
Agora vamos baixar e executar o script de instalação.
O script exige bash, git e Python 3.7+ na impressora. Isso já vem pré-instalado em praticamente todas as impressoras com Klipper.
Etapa 1: baixe o script de instalação:
wget -O moonraker-sp.sh https://download.simplyprint.io/klipper/moonraker-sp.sh && chmod +x moonraker-sp.sh
Etapa 2: execute o instalador:
./moonraker-sp.sh --install
Pode ser que peçam uma senha, use makerbase.
Isso pode demorar um pouco, não se preocupe!
Quando o script disser "Installing moonraker dependencies...", pode levar até 10 minutos. A placa da impressora não é muito potente, e ela está atualizando pacotes Python em segundo plano. Não cancele nem reinicie, apenas espere terminar.
5. Obtenha seu código de configuração
Quando o script terminar, ele vai exibir o código de configuração da sua impressora.
Use este código para vincular sua impressora no painel do SimplyPrint, ou confira se sua impressora aparece automaticamente em Impressoras pendentes.
É isso!
Sua impressora agora está rodando uma instância nova do Moonraker com o SimplyPrint ativado. Você pode continuar usando a tela touch da sua impressora e a configuração Klipper existente normalmente.
O que este script faz? Ele instala uma instância separada e atualizada do Moonraker com o componente do SimplyPrint ao lado da sua configuração de impressora existente. Sua configuração do Klipper e a interface web (Mainsail/Fluidd) existentes não são modificadas. A nova instância do Moonraker roda em uma porta diferente e só cuida da conexão com o SimplyPrint.
É isso! Tudo pronto
Agora você está pronto para conectar sua impressora e começar a usar o SimplyPrint.
Criar sua conta gratuita