# Installation

**URL:** https://community.penpot.app/c/self-host/installation/11.md

[Latest](https://community.penpot.app/latest.md) · [Categories](https://community.penpot.app/categories.md) · [Tags](https://community.penpot.app/tags.md)

---

## [Run Penpot locally!](https://community.penpot.app/t/run-penpot-locally/17)

<div class="topic-metadata">

**Author:** [@diacritica](https://community.penpot.app/u/diacritica)\
**Replies:** 0\
**Last updated:** [January 20, 2022, 3:26pm UTC](https://community.penpot.app/t/run-penpot-locally/17 "2022-01-20T15:26:56Z")

</div>

Installation - Need help setting up the platform on your infrastructure? Get guidance for a smooth installation process. Install Docker Install with Elestio Install with Kubernetes Unofficial self-host options

---

## [Mcp integrations missing from self-hosted docker integratio](https://community.penpot.app/t/mcp-integrations-missing-from-self-hosted-docker-integratio/10861)

<div class="topic-metadata">

**Author:** [@matthieu\_Bruneau](https://community.penpot.app/u/matthieu_Bruneau)\
**Replies:** 1\
**Last updated:** [September 3, 2026, 2:50am UTC](https://community.penpot.app/t/mcp-integrations-missing-from-self-hosted-docker-integratio/10861 "2026-09-03T02:50:41Z")

</div>

Hello, I am trying to use the mcp server with my docker self-hosted penpot. I am using the default docker-compose file from the dock. But when I am trying to activate the integrations, I don’t have anything like in the …

---

## [How to deploy Penpot self-hosted under a subpath context?](https://community.penpot.app/t/how-to-deploy-penpot-self-hosted-under-a-subpath-context/10500)

<div class="topic-metadata">

**Author:** [@aantona](https://community.penpot.app/u/aantona)\
**Replies:** 0\
**Last updated:** [April 14, 2026, 11:35am UTC](https://community.penpot.app/t/how-to-deploy-penpot-self-hosted-under-a-subpath-context/10500 "2026-04-14T11:35:38Z")

</div>

I have successfully deployed Penpot using Docker on my own server, with Nginx acting as a reverse proxy. Currently, I am trying to configure the application to run under a subpath context (e.g., my.domain.corporate/penp…

---

## [Cant run docker on my machine](https://community.penpot.app/t/cant-run-docker-on-my-machine/10429)

<div class="topic-metadata">

**Author:** [@Dronger\_Lexor](https://community.penpot.app/u/Dronger_Lexor)\
**Replies:** 0\
**Last updated:** [March 18, 2026, 9:13am UTC](https://community.penpot.app/t/cant-run-docker-on-my-machine/10429 "2026-03-18T09:13:16Z")

</div>

How can I install :thinking: penpot without having to install docker coz it doesn’t run on my machine… is there a way to run it o wsl2?

---

## [Installation using Docker in an air-gapped environment](https://community.penpot.app/t/installation-using-docker-in-an-air-gapped-environment/9150)

<div class="topic-metadata">

**Author:** [@dreamyoon](https://community.penpot.app/u/dreamyoon)\
**Replies:** 3\
**Last updated:** [March 7, 2026, 2:09pm UTC](https://community.penpot.app/t/installation-using-docker-in-an-air-gapped-environment/9150 "2026-03-07T14:09:02Z")

</div>

The following flags do not work in air-gapped environments: PENPOT\_FLAGS: enable-air-gapped-conf Online, Docker installation and 6 containers worked normally. However, when offline, 1 container (frontend:latest) out of…

---

## [Invitation only self-hosted setup](https://community.penpot.app/t/invitation-only-self-hosted-setup/2140)

<div class="topic-metadata">

**Author:** [@Furai](https://community.penpot.app/u/Furai)\
**Replies:** 5\
**Last updated:** [January 24, 2026, 1:38pm UTC](https://community.penpot.app/t/invitation-only-self-hosted-setup/2140 "2026-01-24T13:38:28Z")

</div>

Hey all, To start off - I’m running Penpot v1.16 through docker. I’m having issue figuring out how to make invitation only setup working. I’ve set up SMTP and all that without issues within minutes. I’m getting invitat…

---

## [Penpot install: does not exist or no pull access error](https://community.penpot.app/t/penpot-install-does-not-exist-or-no-pull-access-error/10142)

<div class="topic-metadata">

**Author:** [@Gavin\_Lo](https://community.penpot.app/u/Gavin_Lo)\
**Replies:** 1\
**Last updated:** [December 5, 2025, 9:13am UTC](https://community.penpot.app/t/penpot-install-does-not-exist-or-no-pull-access-error/10142 "2025-12-05T09:13:56Z")

</div>

When I tried to install Penpot on Linux, I got an error message that says “repository docker.io/penpotapp/frontend not found: does not exist or no pull access”. How can I fix this issue?

---

## [Penpot self host](https://community.penpot.app/t/penpot-self-host/10085)

<div class="topic-metadata">

**Author:** [@Crimson\_Moon4](https://community.penpot.app/u/Crimson_Moon4)\
**Replies:** 2\
**Last updated:** [November 17, 2025, 1:04pm UTC](https://community.penpot.app/t/penpot-self-host/10085 "2025-11-17T13:04:09Z")

</div>

Hello I needs some help i want to self-host using docker but the problem is showing me this idk why what to do i follow every single step but still give me this error what to do pls help me to fix this

---

## [Blank page on first launch](https://community.penpot.app/t/blank-page-on-first-launch/9886)

<div class="topic-metadata">

**Author:** [@Deliverator](https://community.penpot.app/u/Deliverator)\
**Replies:** 2\
**Last updated:** [September 24, 2025, 9:06am UTC](https://community.penpot.app/t/blank-page-on-first-launch/9886 "2025-09-24T09:06:33Z")

</div>

Hello! After launching the docker compose, it does turn on without any problem but accessing the frontend only shows a blank page. I’m installing Penpot through a Docker Container. I’m using Dockge to manage the Docker…

---

## [Raspberry Docker: "no matching manifest for linux/arm/v7"](https://community.penpot.app/t/raspberry-docker-no-matching-manifest-for-linux-arm-v7/9835)

<div class="topic-metadata">

**Author:** [@flo1](https://community.penpot.app/u/flo1)\
**Replies:** 0\
**Last updated:** [September 16, 2025, 8:10am UTC](https://community.penpot.app/t/raspberry-docker-no-matching-manifest-for-linux-arm-v7/9835 "2025-09-16T08:10:46Z")

</div>

Hi there, New to Penpot, I installed it smoothly with Docker on a standard x86\_64 desktop to test it and would now like to install it on my RPi. When using the compose file and running pull, I am getting a “no matching…

---

## [Penpot crashes when saving files](https://community.penpot.app/t/penpot-crashes-when-saving-files/9736)

<div class="topic-metadata">

**Author:** [@Christelle](https://community.penpot.app/u/Christelle)\
**Replies:** 7\
**Last updated:** [August 19, 2025, 10:25am UTC](https://community.penpot.app/t/penpot-crashes-when-saving-files/9736 "2025-08-19T10:25:47Z")

</div>

Hi! I installed a Penpot instance via Docker on a Debian VM last November and everything was working perfectly. Not knowing anything about Docker, I couldn’t update it correctly and had to reinstall everything in Febru…

---

## [When the container does not run while completely offline.](https://community.penpot.app/t/when-the-container-does-not-run-while-completely-offline/9180)

<div class="topic-metadata">

**Author:** [@g.dream.yoon](https://community.penpot.app/u/g.dream.yoon)\
**Replies:** 1\
**Last updated:** [July 11, 2025, 2:46pm UTC](https://community.penpot.app/t/when-the-container-does-not-run-while-completely-offline/9180 "2025-07-11T14:46:53Z")

</div>

As shown in the image below, I have installed Docker locally and confirmed that it is running correctly after executing compose up. However, when I remove the LAN line and run compose up in a completely offline state…

---

## [Site displays Service Unavailable after helm chart install](https://community.penpot.app/t/site-displays-service-unavailable-after-helm-chart-install/8014)

<div class="topic-metadata">

**Author:** [@hathpint](https://community.penpot.app/u/hathpint)\
**Replies:** 2\
**Last updated:** [May 24, 2025, 7:25am UTC](https://community.penpot.app/t/site-displays-service-unavailable-after-helm-chart-install/8014 "2025-05-24T07:25:26Z")

</div>

After helm chart installation of penpot, this is a screenshot of what I get when I attempt to reach the site. As far as values… here’s what I’m passing… but essentially, I’m using AWS RDS - postgreSQL for database, S3…

---

## [S3 bucket used with another provider than AWS](https://community.penpot.app/t/s3-bucket-used-with-another-provider-than-aws/8827)

<div class="topic-metadata">

**Author:** [@smalot](https://community.penpot.app/u/smalot)\
**Replies:** 0\
**Last updated:** [May 24, 2025, 7:21am UTC](https://community.penpot.app/t/s3-bucket-used-with-another-provider-than-aws/8827 "2025-05-24T07:21:07Z")

</div>

Hi ! I’m currently facing issues while trying to upload file from my self-hosted deployment. The storage engine is a S3 bucket provided by OVH Public Cloud. I correctly setup the endpoint and credentials, but I’m askin…

---

## [How can we improve the Self-Hosting experience?](https://community.penpot.app/t/how-can-we-improve-the-self-hosting-experience/7572)

<div class="topic-metadata">

**Author:** [@carolina.portugal](https://community.penpot.app/u/carolina.portugal)\
**Replies:** 9\
**Last updated:** [April 24, 2025, 9:37am UTC](https://community.penpot.app/t/how-can-we-improve-the-self-hosting-experience/7572 "2025-04-24T09:37:39Z")

</div>

We’re constantly working to make Penpot better for everyone, and right now, we’re focusing on improving the self-host experience. Whether you’re a seasoned pro at hosting Penpot or just starting out, we want to hear from…

---

## [What is the best way to install Penpot?](https://community.penpot.app/t/what-is-the-best-way-to-install-penpot/7862)

<div class="topic-metadata">

**Author:** [@csmu](https://community.penpot.app/u/csmu)\
**Replies:** 0\
**Last updated:** [February 17, 2025, 7:27am UTC](https://community.penpot.app/t/what-is-the-best-way-to-install-penpot/7862 "2025-02-17T07:27:05Z")

</div>

We self host Taiga and it has a Penpot docker compose file. Does that get the latest version of Penpot?

---

## [\[Self Hosted\]\[OIDC\] how to direct login via OIDC sso](https://community.penpot.app/t/self-hosted-oidc-how-to-direct-login-via-oidc-sso/4639)

<div class="topic-metadata">

**Author:** [@LePapalouf](https://community.penpot.app/u/LePapalouf)\
**Replies:** 1\
**Last updated:** [January 28, 2025, 9:46pm UTC](https://community.penpot.app/t/self-hosted-oidc-how-to-direct-login-via-oidc-sso/4639 "2025-01-28T21:46:07Z")

</div>

Hello all :smiley: I correctly configured OIDC login between my self hosted penpot and my Authentik SSO , but now i’m looking for a way to not having to click on the OpenID button and directly being redirected to the SS…

---

## [Self hosting on kubernetes](https://community.penpot.app/t/self-hosting-on-kubernetes/5701)

<div class="topic-metadata">

**Author:** [@suityou01](https://community.penpot.app/u/suityou01)\
**Replies:** 1\
**Last updated:** [January 7, 2025, 5:46pm UTC](https://community.penpot.app/t/self-hosting-on-kubernetes/5701 "2025-01-07T17:46:53Z")

</div>

I have successfully got penpot and it’s various systems running in the same pod. The backend has migrated it’s tables to the database. However when I go to the front end I am greeted with an error : “Something bad happ…

---

## [Frontend is unreachable while self hosting](https://community.penpot.app/t/frontend-is-unreachable-while-self-hosting/3537)

<div class="topic-metadata">

**Author:** [@talentlessguy](https://community.penpot.app/u/talentlessguy)\
**Replies:** 5\
**Last updated:** [December 25, 2024, 8:21am UTC](https://community.penpot.app/t/frontend-is-unreachable-while-self-hosting/3537 "2024-12-25T08:21:09Z")

</div>

Hi, I’m trying to self host Penpot on my home server using Docker guide and a Caddy server. My docker-compose.yml file: --- version: "3.5" networks: penpot: volumes: penpot\_postgres\_v15: penpot\_assets: servic…

---

## [Preview not loading of the files in self hosted version](https://community.penpot.app/t/preview-not-loading-of-the-files-in-self-hosted-version/7355)

<div class="topic-metadata">

**Author:** [@Pravin\_shinde\_93](https://community.penpot.app/u/Pravin_shinde_93)\
**Replies:** 0\
**Last updated:** [December 15, 2024, 5:45pm UTC](https://community.penpot.app/t/preview-not-loading-of-the-files-in-self-hosted-version/7355 "2024-12-15T17:45:17Z")

</div>

Hi I have recently self hosted a penpot version using coolify on my VPS but it looks like there are a lot of bugs or maybe i did something wrong but the preview is not loading and when I open any file to edit the preview…

---

## [How to deploy PenPot 2.0 self-hosted](https://community.penpot.app/t/how-to-deploy-penpot-2-0-self-hosted/5011)

<div class="topic-metadata">

**Author:** [@miguelgargallo](https://community.penpot.app/u/miguelgargallo)\
**Replies:** 2\
**Last updated:** [November 26, 2024, 8:51am UTC](https://community.penpot.app/t/how-to-deploy-penpot-2-0-self-hosted/5011 "2024-11-26T08:51:49Z")

</div>

How to deploy PenPot 2.0 self-hosted

---

## [PenPot Newbie Help!](https://community.penpot.app/t/penpot-newbie-help/6870)

<div class="topic-metadata">

**Author:** [@jonjg](https://community.penpot.app/u/jonjg)\
**Replies:** 2\
**Last updated:** [October 24, 2024, 7:29am UTC](https://community.penpot.app/t/penpot-newbie-help/6870 "2024-10-24T07:29:19Z")

</div>

Hi all, New to PenPot, looking at it as an alternative to Figma for certain projects, I’m overall impressed but have a slight issue that I’m not sure if its user error or an issue with PenPot, when I’m looking to string…

---

## [Challenges while trying to move from v1.x to v2](https://community.penpot.app/t/challenges-while-trying-to-move-from-v1-x-to-v2/6820)

<div class="topic-metadata">

**Author:** [@Joonaster](https://community.penpot.app/u/Joonaster)\
**Replies:** 2\
**Last updated:** [October 22, 2024, 12:18pm UTC](https://community.penpot.app/t/challenges-while-trying-to-move-from-v1-x-to-v2/6820 "2024-10-22T12:18:36Z")

</div>

Hey! I know there has been quite a lot challenges after the major update to V2 world. I’m in that boat and we have had zero success while trying to move our self hosted design files to the new era. I’ve given up alread…

---

## [1.17 to 2.1.1 : trouble with image and font](https://community.penpot.app/t/1-17-to-2-1-1-trouble-with-image-and-font/6187)

<div class="topic-metadata">

**Author:** [@conception](https://community.penpot.app/u/conception)\
**Replies:** 7\
**Last updated:** [August 14, 2024, 8:32am UTC](https://community.penpot.app/t/1-17-to-2-1-1-trouble-with-image-and-font/6187 "2024-08-14T08:32:50Z")

</div>

Hello, For several reasons, we choice the self-hosted solution in docker. We use this version : 1.17 We have some trouble with this version and in particular this one : • Into a project, on design page, when we would…

---

## [Trying the new 2.0.0 - And getting some odd issues with CSS](https://community.penpot.app/t/trying-the-new-2-0-0-and-getting-some-odd-issues-with-css/5016)

<div class="topic-metadata">

**Author:** [@icsy7867](https://community.penpot.app/u/icsy7867)\
**Replies:** 1\
**Last updated:** [July 18, 2024, 1:41pm UTC](https://community.penpot.app/t/trying-the-new-2-0-0-and-getting-some-odd-issues-with-css/5016 "2024-07-18T13:41:18Z")

</div>

Hello! I am trying out the new 2.0.0 version and loving the improvement. I currently have several docker containers and using an nginx proxy. Everything seems to work alright, except for some oddities. One of the mos…

---

## [First time - unable to login](https://community.penpot.app/t/first-time-unable-to-login/4531)

<div class="topic-metadata">

**Author:** [@nextideas](https://community.penpot.app/u/nextideas)\
**Replies:** 2\
**Last updated:** [July 5, 2024, 6:14am UTC](https://community.penpot.app/t/first-time-unable-to-login/4531 "2024-07-05T06:14:34Z")

</div>

Hi fellas, my first time here. Its a plesure to be part of this community. i just finished the install on my local docker vps, and i am getting some issues. the config yam file has only changes on smtp details, everthi…

---

## ["Bad Gateway" error on Raspberry Pi](https://community.penpot.app/t/bad-gateway-error-on-raspberry-pi/4302)

<div class="topic-metadata">

**Author:** [@bliepp](https://community.penpot.app/u/bliepp)\
**Replies:** 4\
**Last updated:** [April 4, 2024, 8:38am UTC](https://community.penpot.app/t/bad-gateway-error-on-raspberry-pi/4302 "2024-04-04T08:38:05Z")

</div>

Hey guys, I recently came accros this software and wanted to try self-host this. I followed the installation guide exactly but I always get that “Bad Gateway” error. I tested it on a Raspberry Pi 4 with a fresh installat…

---

## [I get an error when I access Penpot deployed in Docker:](https://community.penpot.app/t/i-get-an-error-when-i-access-penpot-deployed-in-docker/5850)

<div class="topic-metadata">

**Author:** [@Ho\_Chan](https://community.penpot.app/u/Ho_Chan)\
**Replies:** 0\
**Last updated:** [June 26, 2024, 7:51am UTC](https://community.penpot.app/t/i-get-an-error-when-i-access-penpot-deployed-in-docker/5850 "2024-06-26T07:51:09Z")

</div>

I get an error when I access Penpot deployed in Docker: Hint: http error Prof ID: -- Team ID: -- Data: {:type :unexpected-error, :status 404, :data "(...)", :hint "http error"} Trace: Error: http error at …

---

## [Unable to view images](https://community.penpot.app/t/unable-to-view-images/4987)

<div class="topic-metadata">

**Author:** [@Luigi\_Gorlero](https://community.penpot.app/u/Luigi_Gorlero)\
**Replies:** 3\
**Last updated:** [June 19, 2024, 8:29pm UTC](https://community.penpot.app/t/unable-to-view-images/4987 "2024-06-19T20:29:13Z")

</div>

Hello :wave: I am self hosting PenPot through Docker and Traefik using the provided compose file. I was testing the simplest config and everything worked great. Trying to switch assets from FS to S3 (using Cloudflare R…

---

## [Penpot + Nginx issue, error 502](https://community.penpot.app/t/penpot-nginx-issue-error-502/5663)

<div class="topic-metadata">

**Author:** [@pmuge](https://community.penpot.app/u/pmuge)\
**Replies:** 1\
**Last updated:** [June 11, 2024, 1:38pm UTC](https://community.penpot.app/t/penpot-nginx-issue-error-502/5663 "2024-06-11T13:38:19Z")

</div>

Hello, I host Penpot on a Debian 12 VM, until then it worked fine. Since I want to use Nginx in front of my Penpot instance, I can’t reach my website. The frontend instance is in restart loop. Here are my configurati…

[Next page](https://community.penpot.app/c/self-host/installation/11.md?page=1)
