Printoid is really easy to use and to configure for the first time. The connection to OctoPrint requests you to provide a few parameters.
But, of course, Printoid can’t do all the magik.
You need to ensure first that your OctoPrint server is properly installed, configured, and reachable from a web browser first.
Please read this tutorial before.
1/ The basic settings
You can provide the name you want for this OctoPrint profile.
It will be used for informative display only, so it can be the 3D printer name or model, or whatever you want.
Local IP or hostname (LAN):
This is the IP (or hostname) of your OctoPrint server on your local network.
This field is not mandatory if you only want to provide the public IP (or hostname)
You can use the “magnifying glass” icon to search for OctoPrint servers on your server automatically (using the UPnP service). In this case, please ensure that your device is connected to the same network as your OctoPrint server.
Local IP port
In the field on the right of the Local IP, you can add a local IP port if needed.
This field is optional, you can let it empty. By default, the port 80 will be used (the default port for the HTTP protocol)
If your OctoPrint server runs only on port 5000, you can provide 5000 in this field.
Public IP or hostname (WAN)
This is the public IP (or hostname) of your router over the Internet. You can find this value here if your browser is connected to the network of your rooter.
You can also let Printoid retrieving your public IP. To do that, please be sure that your device is currently connected to the same network as your OctoPrint server.
This field is not mandatory if you only want to provide the local IP (or hostname)
You can use the “magnifying glass” icon to feed this field automatically. In this case, please ensure that your device is connected to the same network as your OctoPrint server.
On the right field, you can add a public port.
This field is mandatory if you have provided a public IP address.
This field is optional if you have provided a public hostname which already redirects to your public IP that also contains the port value.
Please read this tutorial if you want to know how to make OctoPrint reachable over the Internet.
OctoPrint API key
This is the private key provided by your OctoPrint server. This field is mandatory.
Where can I find my OctoPrint API key ?
You can find this value in your OctoPrint web interface > Settings > API (please ensure that you are properly logged-in in your OctoPrint web interface)
In the API setting page (arrow #1):
- The value you need is the API key (arrow #3)
- Don’t forget to check the box “Enable API” if not already checked yet (arrow #2)
- You can also click on the “QR scanner” icon in Printoid if you don’t want to type the key manually. You will be able to scan the QR code offered by the OctoPrint web interface in the Settings > API menu. (arrow #4)
Please note that “N/A” is not a valid API key. If this is the value showing in your OctoPrint web interface.
This is the communication baudrate between your OctoPrint server and your 3D printer. This value only depends on your 3D printer firmware.
This field is mandatory. You can select “AUTO” if you want to let OctoPrint finding the right baudrate value or if you do not know the baudrate of your 3D printer.
2/ The extended settings
Click on the “+ extended settings (optional)” button to show the advanced parameters.
Communication using SSL
If you should use SSL to connect to your OctoPrint server, then you can enable “Use HTTPS protocol instead of HTTP”.
If you still have connection issue (certificate not trusted for example), you can enable “Auto-trust self-signed certificate”.
If your OctoPrint server is protected by a basic per-user authentication, you can enable “Use per-user credentials”.
If you have checked this last box, then please provide the correct Username and Password.
Please double check the provided values in order to prevent connection issues.
SSH parameters (for custom commands)
Printoid PRO and PREMIUM allow you to send your own SSH commands to your Raspberry Pi directly from the app.
So you need to provide some informations about the SSH parameters.
The login value is the username of your session on your Raspberry Pi. Most of time (with Raspbian or OctoPi), the login is pi
The password value is the password associated to your session on your Raspberry Pi. If you have not changed the default Raspbian (or OctoPi) password, the value is raspberry
The port for the distant SSH sessions is optional. The port 22 will be used by default if you are connected to your local network.
The port value is mandatory for distant SSH commands (over the Internet). Please see this tutorial.
Web socket path
Unless you’ve changed the default OctoPrint server’s websocket path, please do not edit this value.
Printoid does not collect any of these provided informations.
Nobody can see what’s your IP or hostname.
You can read the full privacy policies here.