# Deploy MMP with Easypanel

URL: /templates/mmp

Maker Management Platform (MMP) is an open-source self-hosted system for organising and managing 3D printing and maker projects. It provides a web UI with a visual library of STL and 3MF files, automatically renders 3D model thumbnails, manages project collections with linked assets (models, slices, images, and documents), and integrates with Klipper and OctoPrint to send slices directly to your printer. Projects can be imported from Thingiverse via the MMP Companion browser extension. The stack is two containers — a Go backend agent and a React frontend — with all state stored in local volumes.

## Installation notes

Open the UI at your domain after deployment. On first load you will see an empty library. The agent scans the /library volume for STL, 3MF, and other maker files and renders 3D previews automatically in the background.
To use slicer integration, ensure port 8000 on the agent service is reachable from your slicer (it is published as a host port). See the MMP documentation for PrusaSlicer / Orca Slicer configuration.
To import projects from Thingiverse, add your Thingiverse API token to the thingiverseToken field, or edit /data/config.toml inside the agent container after first run.

## Benefits

### Visual 3D Library

MMP automatically scans your library folder and renders colour-coded 3D preview thumbnails for every STL and 3MF file, giving you a visual grid of all your models without opening a slicer.

### Send Slices to Printer

Integrates with Klipper and OctoPrint so you can send a slice file directly to your printer from within the MMP UI — no file transfers or USB sticks required.

### Project Collections

Group related files into projects and attach any combination of models, slice files, images, and documents. Everything stays together and searchable in one place.

### Import from Thingiverse

Use the MMP Companion browser extension or the built-in Thingiverse importer (with an API token) to pull projects directly into your local library.

## Features

### Automatic Model Rendering

The Go agent renders STL and 3MF files to PNG thumbnails in parallel using a configurable worker pool (default 5 workers) so large libraries are processed quickly.

### Asset Management

Each project can hold multiple asset types — models, print profiles, reference images, and documents — all browsable from a single project detail view.

### Printer Integration

Add Klipper or OctoPrint printer endpoints and upload slice files (G-code) directly from the MMP UI without leaving the browser.

### Thingiverse Import

Provide a Thingiverse API token to import public projects (models, images, descriptions) directly into your local MMP library.

### Slicer Integration

Configure PrusaSlicer or Orca Slicer to post-process prints through MMP via port 8000 for a seamless library-to-printer workflow.

## Configuration

- `appServiceName` (App Service Name, required): mmp

- `agentServiceImage` (Agent Image, required): ghcr.io/maker-management-platform/agent:v1.3.2

- `uiServiceImage` (UI Image, required): ghcr.io/maker-management-platform/mmp-ui:v1.3.0

- `thingiverseToken` (Thingiverse API Token): Set during installation — Optional. Allows MMP to import projects directly from Thingiverse. Get a token at https://www.thingiverse.com/apps/create.

- `modelRenderColor` (3D Model Render Color): #167DF0 — Hex colour used when rendering 3D model preview images.

## Services

- mmp-agent: app (ghcr.io/maker-management-platform/agent:v1.3.2)

- mmp: app (ghcr.io/maker-management-platform/mmp-ui:v1.3.0)

## Resources

- [GitHub (Agent)](https://github.com/maker-management-platform/agent)

- [GitHub (UI)](https://github.com/maker-management-platform/mmp-ui)

- [Documentation](https://github.com/Maker-Management-Platform/docs)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/mmp)