# Penpot Docker Extension — One-Click Self-Hosted Design 🚀

**URL:** <https://community.penpot.app/t/penpot-docker-extension-one-click-self-hosted-design/10120>\
**Category:** Self-host\
**Tags:** community, design\
**Created:** [November 26, 2025, 5:25pm UTC](https://community.penpot.app/t/penpot-docker-extension-one-click-self-hosted-design/10120 "2025-11-26T17:25:56Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Ajeet\_Singh](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/ajeet_singh/32/9401_2.png) [@Ajeet\_Singh](https://community.penpot.app/u/Ajeet_Singh)\
**Post date:** [November 26, 2025, 5:25pm UTC](https://community.penpot.app/t/penpot-docker-extension-one-click-self-hosted-design/10120/1 "2025-11-26T17:25:56Z")

</div>

Hey Penpot Community! 👋

I’m excited to share something I’ve been working on: the **Penpot Docker Extension** — a tool that brings one-click deployment of a complete self-hosted Penpot instance directly into Docker Desktop.

### The Problem

Setting up a self-hosted Penpot environment traditionally involves:

- Downloading docker-compose.yaml files

- Configuring environment variables

- Running terminal commands

- Manually checking service health

For developers and designers who just want to _design_, this can be a hurdle.

### The Solution

The Penpot Docker Extension transforms this multi-step process into a **single-click deployment** right from the Docker Desktop dashboard.

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/penpot/original/2X/1/120033cd06cd314ac3ad82b8617ab4176638a45d.png)

### ✨ Features

- **One-Click Deployment** — Start the complete Penpot stack instantly

- **Real-Time Status Monitoring** — See the health of all 6 services at a glance

- **Service Management** — Start, stop, restart individual services

- **Integrated Logs Viewer** — Troubleshoot without leaving Docker Desktop

- **Quick Access Links** — Jump straight to Penpot UI (port 9001) or MailCatcher (port 1080)

### 🛠 What Gets Deployed

The extension spins up the full Penpot stack:

| Service | Purpose |
| --- | --- |
| penpot-frontend | Web UI (Port 9001) |
| penpot-backend | API server |
| penpot-exporter | PDF/image export |
| penpot-postgres | PostgreSQL database |
| penpot-valkey | Cache (Redis-compatible) |
| penpot-mailcatch | Email testing (Port 1080) |

### 📦 Installation

Penpot Docker Extension is now available in the Extension Marketplace.

Open **Docker Desktop** \> **Settings** \> **Extensions** \> **Enable Extensions.**

Search for Penpot \> Click " **Install** ”.

**Requirements:**

- Docker Desktop (latest version)

- 4GB RAM available for Docker

- Ports 9001 and 1080 free

### 🔧 Default Configuration

The extension ships with localhost-friendly defaults:

- Email verification disabled

- Secure session cookies disabled

- MailCatcher as SMTP (view all emails at localhost:1080)

For production use, you can customize the configuration to enable email verification, real SMTP, and secure cookies.

### 🔗 Resources

- **GitHub:** [https://github.com/ajeetraina/penpot-docker-extension](https://github.com/ajeetraina/penpot-docker-extension)

- **Full Blog Post:** [https://www.ajeetraina.com/introducing-the-penpot-docker-extension-one-click-deployment-for-self-hosted-design/](https://www.ajeetraina.com/introducing-the-penpot-docker-extension-one-click-deployment-for-self-hosted-design/)

### Feedback Welcome! 🙏

This is an early release and I’d love your feedback:

- What features would make this more useful?

- Any issues with installation or running?

- Ideas for future improvements?

Let’s make self-hosting Penpot as simple as possible!

Happy designing! 🎨

~ Ajeet