albarreto/octopi-multiarch repository overview

⁠OctoPi Multiarch

OctoPrint multi-architecture Docker image with integrated slicers and commonly used plugins.

⁠Features

octopi-multiarch:latest

• OctoPrint 1.11.7 (Python 3.11)

• Multi-architecture image:

  • AMD64 (Intel/AMD PCs and servers)
  • ARMHF (Raspberry Pi 2 32-bit and compatible devices)
  • ARM64 (Raspberry Pi 3/4/5 64-bit and compatible devices)

• CuraEngine Legacy 15.04.6

  • Path: /opt/CuraEngine/build/CuraEngine

• Slic3r

  • Path: /usr/bin/slic3r

• FFmpeg

  • Path: /usr/bin/ffmpeg

⁠Bundled Plugins

• Slic3r Plugin
• Cura Legacy Plugin
• FullSlicer
• Better Heater Timeout
• UI Customizer
• Navbar Temperature
• MultiColors

⁠Quick Start

docker run -it \
  -p 5000:80 \
  --name octopi \
  --restart=unless-stopped \
  -d \
  --device /dev/ttyUSB0 \
  albarreto/octopi-multiarch:latest

⁠Recommended Deployment

docker run -d -it \
  --name={CONTAINER_NAME} \
  --device /dev/{USB_PORT}:/dev/ttyUSB0 \
  -p {PORT_NUMBER}:80 \
  -v ~/config/{CONTAINER_NAME}:/octoprint/ \
  -v ~/uploads:/octoprint/octoprint/uploads/ \
  --restart=unless-stopped \
  albarreto/octopi-multiarch:latest

Where:

• ~/config/{CONTAINER_NAME} stores the OctoPrint configuration and plugins.
• ~/uploads is a shared host folder containing STL and G-Code files accessible by multiple OctoPrint instances.

⁠Access

http://{docker-host}:{PORT_NUMBER}

Example:

http://192.168.1.100:5001

⁠Notes

• The image automatically selects the correct architecture (AMD64 or ARM64).
• CuraEngine and Slic3r are preinstalled and ready to use.
• Configuration is stored entirely inside /octoprint.
• The octoprint user is configured for access to serial devices through the dialout group.
• Existing configurations from previous OctoPrint installations can be restored by mounting the original /octoprint data directory.

⁠Known Issues

• Serial port auto-detection may not work correctly on some systems.
• If connection fails, manually select the serial port (for example /dev/ttyUSB0 or /dev/ttyACM0) and baud rate (115200).
• Some printers may require manual serial port selection instead of automatic detection.
• Some third-party plugins may require manual updates to support newer OctoPrint releases.

⁠Tested Hardware

⁠AMD64

• Generic Intel/AMD PC

⁠ARM64

• Raspberry Pi 3 (64-bit)
• Raspberry Pi 4 (64-bit)
• Tanix TX3 Mini TV Box
• Tanix TX3 Mini+ TV Box
• Q96 Max TV Box

⁠Tags

• latest – Current stable release
• 1.11 – Latest release in the OctoPrint 1.11.x series
• 1.11.7 – Specific OctoPrint version

⁠Contact

Aurélio Barreto

Email: [email protected]⁠

Languages: English (US) and Portuguese (Brazil)