OctoPrint fornece uma interface web ágil para controlar impressoras 3D de consumo. É Software Livre e lançado sob a Licença Pública Geral GNU Affero V3.
Seu site pode ser encontrado em octoprint.org.
O fórum da comunidade está disponível em community.octoprint.org. Ele também serve como uma base central de conhecimento.
Um convite para o servidor Discord pode ser encontrado em discord.octoprint.org.
O FAQ pode ser acessado seguindo faq.octoprint.org.
A documentação está localizada em docs.octoprint.org.
O repositório oficial de plugins pode ser acessado em plugins.octoprint.org.
O desenvolvimento do OctoPrint não seria possível sem o apoio financeiro da sua comunidade. Se você gosta do OctoPrint, considere se tornar um apoiador regular!
No momento, você está acessando o repositório de código-fonte do OctoPrint. Se você já o instalou (por exemplo, usando a distribuição direcionada do Raspberry Pi, OctoPi) e deseja apenas saber como usá-lo, a documentação pode ser de maior interesse para você. Você também pode se inscrever para participar do fórum da comunidade em community.octoprint.org, onde há outros usuários ativos que podem ajudá-lo com qualquer dúvida que você possa ter.
Contribuições de todos os tipos são bem-vindas, não apenas na forma de código, mas também no que diz respeito à documentação oficial, ajuda de depuração no bug tracker, suporte de outros usuários no fórum da comunidade em community.octoprint.org ou no discord oficial em discord .octoprint.org e também financeiramente.
Se você acha que algo está ruim no OctoPrint ou em sua documentação do jeito que está, por favor, ajude de alguma forma para melhorá-lo, em vez de apenas reclamar - afinal, este é um projeto de código aberto :)
Para obter informações sobre como enviar relatórios de bugs ou solicitações pull, consulte as Diretrizes de Contribuição do projeto.
Instruções de instalação para instalação a partir do código-fonte para diferentes sistemas operacionais podem ser encontradas no fórum.
Se você deseja executar o OctoPrint em um Raspberry Pi, você realmente deveria dar uma olhada no OctoPi, que é uma imagem de cartão SD personalizada que inclui OctoPrint mais dependências.
As etapas genéricas que basicamente devem ser executadas independentemente do sistema operacional e do ambiente de execução são as seguintes (como usuário comum , mantenha as mãos longe do comando sudo
aqui!) - isso pressupõe que você já tenha Python 3.7+, pip e virtualenv e seus dependências configuradas em seu sistema:
virtualenv venv
. Se você deseja especificar um python específico para usar em vez de qualquer versão padrão do seu sistema, você também pode exigir isso explicitamente por meio do parâmetro --python
, por exemplo, virtualenv --python=python3 venv
../venv/bin/pip install OctoPrint
Você pode então iniciar o servidor OctoPrint via /path/to/OctoPrint/venv/bin/octoprint
, consulte Uso para obter detalhes.
Após a instalação, certifique-se de seguir o assistente de primeira execução e configurar o controle de acesso conforme necessário.
OctoPrint depende de alguns módulos python para fazer seu trabalho. Eles são instalados automaticamente ao instalar o OctoPrint via pip
.
OctoPrint atualmente suporta Python 3.7, 3.8, 3.9, 3.10, 3.11 e 3.12.
Executando a instalação do pip via
pip install OctoPrint
instala o script octoprint
na pasta de scripts de instalação do Python (que, dependendo se você instalou o OctoPrint globalmente ou em um ambiente virtual, estará em seu PATH
ou não). Os exemplos de uso a seguir pressupõem que o script octoprint
esteja em seu PATH
.
Você pode iniciar o servidor via
octoprint serve
Por padrão, ele se liga a todas as interfaces na porta 5000 (portanto, apontar seu navegador para http://127.0.0.1:5000
resolverá o problema). Se você quiser mudar isso, use os parâmetros de linha de comando adicionais host
e port
, que aceitam o IP do host ao qual vincular e o número numérico da porta, respectivamente. Se, por exemplo, você quiser que o servidor escute apenas na interface local na porta 8080, a linha de comando seria
octoprint serve --host=127.0.0.1 --port=8080
Alternativamente, o host e a porta na qual vincular podem ser definidos por meio do arquivo de configuração.
Se você deseja executar o OctoPrint como um daemon (suportado apenas no Linux), use
octoprint daemon {start|stop|restart} [--pid PIDFILE]
Se você não fornecer um local de pidfile personalizado via --pid PIDFILE
, ele será criado em /tmp/octoprint.pid
.
Você também pode especificar o arquivo de configuração ou o diretório base (para basear as pastas uploads
, timelapse
e logs
), por exemplo:
octoprint serve --config /path/to/another/config.yaml --basedir /path/to/my/basedir
Para iniciar o OctoPrint no modo de segurança - que desativa todos os plug-ins de terceiros que não vêm com o OctoPrint - use o sinalizador --safe
:
octoprint serve --safe
Consulte octoprint --help
para obter mais informações sobre os parâmetros de linha de comando disponíveis.
OctoPrint também vem com um script run
em seu diretório de origem. Você pode invocá-lo para iniciar o servidor. São necessários os mesmos argumentos de linha de comando do script octoprint
.
Se não for especificado por meio da linha de comando, o arquivo de configuração config.yaml
para OctoPrint será esperado na pasta de configurações, que está localizada em ~/.octoprint
no Linux, em %APPDATA%/OctoPrint
no Windows e em ~/Library/Application Support/OctoPrint
no MacOS.
Uma visão geral abrangente de todas as definições de configuração disponíveis pode ser encontrada na documentação. Observe que as definições de configuração mais comumente usadas também podem ser facilmente editadas na caixa de diálogo de configurações do OctoPrint.
Os serviços de teste entre navegadores são gentilmente fornecidos pelo BrowserStack.
A criação de perfil é feita com a ajuda do PyVmMonitor.
O rastreamento de erros é desenvolvido e patrocinado pela Sentry.