Connecting OctoPrint with Printoid

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


Profile name

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)

Do not add “http://” or “https://”. Only the IP or hostname, for example something like or

Local IP port

On the right field, 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 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)

Do not add “http://” or “https://”. Only the IP or hostname. For example, something like or

Public port

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.

You can find this value under OctoPrint > Settings > API.

Don’t forget to check the box “Enable API” if not already checked yet.

You can also click on the “QR scanner” icon if you don’t want to type the key manually.

Please note that “N/A” is not a valid API key. You should probably restart your server in this case.


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.


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”.

Basic authentication

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.


3/ Privacy policy

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.