OctoPrint and OctoPi Download: The Free Print Server for Your 3D Printer

Latest Versions and Downloads

How this box works

• It is live. Each visit asks GitHub for the newest stable release of OctoPrint, of the OctoPi image and of Raspberry Pi Imager. Your browser keeps the answer for ten minutes; the Refresh button asks again straight away.
• You usually do not download the OctoPi image by hand. Raspberry Pi Imager offers it in its own menu and downloads it for you (see the steps below). The file is listed here for people who prefer to write it manually, with its SHA-256 checksum so you can check the download.
• OctoPrint is installed with pip, not downloaded as a program. The wheel file is the package that pip installs. On a Raspberry Pi with OctoPi you update it from inside OctoPrint instead.
• Test builds are shown separately. OctoPrint publishes release candidates ahead of a new major version. They are for testers and never replace the stable version in the table. See OctoPrint 2.0 release candidates.
• Only files from each project’s own GitHub release path are linked. If GitHub cannot be reached, the table falls back to plain links.

What Is OctoPrint?

The OctoPrint website describes it as “the snappy web interface for your 3D printer”: you control and monitor the printer from a browser instead of from the printer’s own screen or an SD card. It runs on a small computer that is connected to the printer, and it is released as free and open-source software under the GNU Affero General Public License (AGPL). Out of the box it works with most consumer 3D printers, according to the project, and plugins add support for particular printers and many extra features.

OctoPrint, OctoPi and Raspberry Pi Imager: What Is What?

The three names cause most of the confusion, so here they are side by side.

What You Need

Install OctoPi Step by Step

This is the route the OctoPrint site recommends for a Raspberry Pi. Menu names are those used in Raspberry Pi Imager 2.x; older versions word a few steps differently.

Step 1: Install Raspberry Pi Imager on your computer

Use the Imager row in the table above, which highlights the file for your system, or the Raspberry Pi site. On Windows and macOS you run the installer; on Linux you can use the AppImage, and on Raspberry Pi OS the command is:

sudo apt install rpi-imager

Step 2: Choose the device and OctoPi

1. Open Raspberry Pi Imager, select your Raspberry Pi model under Device and choose Next.
2. Under Choose OS, open Other specific-purpose OS, then 3D printing, then OctoPi, and pick OctoPi (stable).
3. The same menu has OctoPi (new experimental camera stack), for Raspberry Pi cameras that the stable image does not support well (see camera and timelapse), and an OctoPi-Klipper entry under OctoKlipperPi (see OctoPrint and Klipper).

Step 3: Choose the SD card and set up the Pi

1. Select the SD card under Storage. Keep Exclude system drives ticked, as Raspberry Pi recommends, so you cannot pick your computer’s own disk by mistake.
2. In the customisation step, set a hostname (or keep octopi), a user name and password, your Wi-Fi name and password with the correct country, and turn on SSH if you may want to log in later. Raspberry Pi strongly recommends doing this now; if you skip it, the system asks for the same details at first boot.
3. Write the card. Imager downloads the OctoPi image and writes it to the card. The OctoPrint site adds an important detail: do not format the card if your computer offers to when it finishes.

Step 4: Boot the Pi and open OctoPrint

1. Put the card in the Raspberry Pi, connect the power and wait a few minutes. The first start takes longer than later ones.
2. On a computer or phone on the same network, open http://octopi.local in a browser. If you chose another hostname, use http:// followed by that name and .local, or use http:// followed by the Pi’s IP address, which you can read from your router’s device list.
3. The setup wizard appears the first time (next section).

First-Run Setup and Access Control

OctoPrint’s documentation says a configuration wizard appears on the first start and lets you create the first administrator account. Work through every page of it and read each choice, because the wizard also covers options such as how OctoPrint checks that the internet is reachable and which optional features to enable.

Connect Your Printer

1. With the printer switched off, connect the USB cable between the Raspberry Pi and the printer’s control board, then switch the printer on.
2. In OctoPrint’s Connection panel choose the serial port and baud rate that your printer uses, then press Connect. Many printers work with the automatic setting; if yours does not, look up the baud rate in the printer’s documentation or firmware settings.
3. When the state shows the printer as operational, check that the temperatures read sensibly, then try a small move before you start a print.
4. Upload a G-code file from your slicer, such as Orca Slicer or Creality Print, and press Print.

Connection settings depend on your printer’s firmware and board. These steps are general guidance, not a replacement for your printer’s manual. In OctoPrint 2.0 the serial connection is handled by a bundled Serial Connector plugin.

Camera and Timelapse

The OctoPi project says that if a USB webcam or the Raspberry Pi camera is detected, a webcam server (MJPG-streamer) starts automatically, and OctoPrint embeds the picture. OctoPrint can also record timelapse videos of your prints.

• Raspberry Pi camera module v2: the OctoPi 1.1.0 release notes say it does not work with the stable image but works with the OctoPi (new experimental camera stack) entry in Raspberry Pi Imager. Pick that entry if you use that camera.
• USB webcams are the simplest choice and work with the stable image.
• Privacy: as noted above, the webcam picture is not protected by OctoPrint’s user accounts.

Install OctoPrint on Other Systems

You do not need OctoPi to run OctoPrint. The OctoPrint download page gives these generic steps for a system that has Python 3 and pip:

python -m venv OctoPrint
OctoPrint/bin/pip install OctoPrint
./OctoPrint/bin/octoprint serve

The first command creates an isolated Python environment in a folder called OctoPrint, the second installs OctoPrint into it, and the third starts the server. By default OctoPrint then listens on port 5000, so open http://localhost:5000 on the same computer. The paths above are for Linux and macOS; Windows uses a Scripts folder instead of bin.

Python versions

• OctoPrint 1.11.x still supports Python 3.7 and 3.8, according to the 2.0 release-candidate announcement.
• OctoPrint 2.0 requires Python 3.9 or newer, and supports Python 3.14.

Other routes the OctoPrint site lists

• An official Docker image for people who run containers.
• octoprint_deploy (a script for Linux) and the OctoPrint-WindowsInstaller (for Windows).
• Octo4a, which runs OctoPrint on an Android phone.
• Platform guides for Linux, Windows and macOS on the OctoPrint community forum.

These are third-party or community tools that the OctoPrint site points to. Check each one’s own page before you use it.

OctoPrint 2.0 Release Candidates

OctoPrint 2.0 has been in release-candidate testing since April 2026, and the stable version in the table above is still the 1.11 line. The announcement of the first release candidate lists what changes, and it is worth reading before you try one:

• Python 3.9 or newer is required. Python 3.7 and 3.8 are dropped.
• Plugins may break. Most long-deprecated programming interfaces were removed, so plugins that ignored deprecation warnings will probably need updates.
• Remote-user trust changed. The old trusted remote user setting was replaced by a list of trusted authentication proxies. If you run OctoPrint behind a reverse proxy, check that list before upgrading.
• The printer connection moved into a plugin. The old serial layer now lives in the bundled Serial Connector plugin, and other connectors, such as Moonraker and Bambu, are separate plugins that were still in progress at the time.
• A downgrade may be needed. It is a release candidate, so severe bugs are possible and the announcement links rollback guides.

OctoPrint and Klipper

OctoPrint is a web interface and print server, while Klipper is printer firmware, so they are not rivals. Klipper’s installation guide lists OctoPrint as one of the web interfaces you can use with it, next to Mainsail and Fluidd, and Raspberry Pi Imager’s 3D printing menu has an OctoPi-Klipper entry (OctoPi with the latest Klipper) under OctoKlipperPi. In OctoPrint 2.0 other connectors, such as Moonraker and Bambu, are planned as separate plugins.

If you only want to monitor and manage prints, OctoPrint on the printer’s existing firmware is the shorter road. If you also want Klipper’s motion features, read the Klipper install guide first.

Updating OctoPrint and Adding Plugins

• Software Update plugin. OctoPrint ships with a bundled Software Update plugin that checks for new versions of OctoPrint and of installed plugins. On OctoPi you normally update from inside OctoPrint, not by writing a new SD card.
• Plugin Manager. A bundled Plugin Manager lists plugins from the official plugin repository and installs them. Install only what you need, because every plugin is more code running next to your printer.
• Before a big update, do it when the printer is idle, read the release notes for heads-ups (the 1.11.8 notes link a collection of common update problems) and note the plugins you use.
• Reading about a problem. If an update fails, the OctoPrint community forum is the project’s own support channel.

Is It Safe to Put OctoPrint on the Internet?

Keep OctoPrint on your home network unless you know exactly what you are doing. A printer interface can start a heated nozzle and a motor, and the community’s advice on safe remote access strongly discourages forwarding a port from your router straight to OctoPi. Access control helps, but it does not cover the webcam picture, and a password sent over plain HTTP can be read by someone on the path.

• Use accounts. Keep access control on and give each person the lowest group that does the job.
• For remote access, prefer a VPN into your home network or one of the remote-access plugins and services the community describes, instead of opening a port.
• Never leave a printer unattended while heating. Remote control does not replace a smoke alarm and a safe place to print.

Troubleshooting