---
title: "Deploy Penpot"
description: "Design, prototype and hand off UI with your team on your own server."
category: "Other"
url: https://railway.com/deploy/penpot-design-tool
---

# Deploy Penpot

Design, prototype and hand off UI with your team on your own server.

**[Deploy Penpot on Railway](https://railway.com/template/penpot-design-tool)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/penpot-design-tool/manifest.json

- **Creator:** blueorange
- **Category:** Other

## Template content

### penpot-backend

- **Image:** penpotapp/backend:2.18.3@sha256:2df1b3440d2a82cc3571db211b4ffdfa2b89ccc910759e8d5e9387fb62971b5c
- **Start command:** `/bin/bash -c 'python3 -m http.server 6070 --bind :: --directory /opt/data/assets >/dev/null 2>&1 & exec /bin/bash run.sh'`
- **Health check:** /readyz

### penpot-frontend

- **Image:** penpotapp/frontend:2.18.3@sha256:bb8abe27d53de84c95597f2c02c0e702b2779971fb0703e543f9ecf183e999f6
- **Start command:** `/bin/bash -c 'printf "upstream penpot-backend { zone penpot_backend 64k; server %s:6060 resolve; }\nupstream penpot-exporter { zone penpot_exporter 64k; server %s:6061 resolve; }\nupstream penpot-assets { zone penpot_assets 64k; server %s:6070 resolve; }\n" "$PENPOT_BACKEND_HOST" "$PENPOT_EXPORTER_HOST" "$PENPOT_BACKEND_HOST" > /etc/nginx/overrides/http.d/railway-upstreams.conf && printf "location ~ ^/internal/assets/(.*)\$ { internal; proxy_pass http://penpot-assets/\$1; proxy_hide_header Content-Type; include /etc/nginx/nginx-security-headers.conf; }\n" > /etc/nginx/overrides/server.d/railway-assets.conf && exec /bin/bash /entrypoint.sh nginx -g "daemon off;"'`
- **Health check:** /
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18.6@sha256:fcc6686a3f4f1962fe4ed77a15884553b7bd611ae1cea3204687968c5c09d517

### Valkey

- **Image:** valkey/valkey:8.1.10@sha256:640c5e62cea04b6d6f2084232651d0cc70362d31f4f805e7be94dbed6855e8f2

### penpot-exporter

- **Image:** penpotapp/exporter:2.18.3@sha256:418232d6ca3120b1c2bfde298a56a05a1f41f567cd8494deac3fe7fbc186cfbd
- **Health check:** /readyz

## Documentation

# Deploy and Host Penpot on Railway

![Penpot logo](https://github.com/penpot.png)

Penpot is an open source **design and prototyping platform** for product teams, and the best-known open source alternative to Figma. Designers and developers work together in the browser on UI designs, interactive prototypes, design systems and code handoff. Penpot uses open web standards: designs are SVG, layouts use CSS flexbox and grid, and developers can inspect CSS, SVG and HTML directly. It is MPL-2.0 licensed with about 62,000 GitHub stars, and 2.19.2 shipped in November 2026; this template runs Penpot 2.18.3 with every image pinned by digest. It deploys the full stack on Railway: frontend, backend, exporter, PostgreSQL and Valkey, with a volume for uploads. Figma Professional costs $16 per full seat per month billed yearly, or $20 monthly. Penpot on Railway costs about $15–30/month for your whole team.

---

## What This Template Deploys

| Service | Purpose |
|---|---|
| **penpot-frontend** | `penpotapp/frontend:2.18.3`, nginx and the web app on port `8080` with a public domain. Routes API, exporter and asset requests over the private network. |
| **penpot-backend** | `penpotapp/backend:2.18.3`, the API and real-time server, with a volume at `/opt/data/assets` for uploads, fonts, thumbnails and exports. |
| **penpot-exporter** | `penpotapp/exporter:2.18.3`, a headless browser that renders PNG, JPEG, SVG and PDF exports. |
| **Postgres** | `postgres-ssl:18.6`, private only. Holds teams, projects, files and history. |
| **Valkey** | `valkey:8.1.10` with a password, for real-time notifications between users. |

---

## About Hosting Penpot

Design files are a company's product roadmap. Hosted design tools charge per editor, change pricing and plans over time, and keep every file on their servers. Penpot gives your team a full design tool with unlimited editors on infrastructure you control.

**Design.** Vector editing, boolean operations, text, images, masks, components with variants, and layout with flexbox and CSS grid.

**Prototyping.** Link boards with interactions, transitions and overlays, and present clickable prototypes in the browser.

**Design systems.** Shared libraries of components, colors, typographies and design tokens across files and teams.

**Real-time collaboration.** Multiple people edit the same file at once, with comments, mentions and version history.

**Developer handoff.** Inspect mode shows CSS, SVG and HTML for any element, so developers read real code instead of guessing.

**Import and export.** Import Figma files through community tools, and export to PNG, JPEG, SVG and PDF.

**Plugins.** Extend Penpot with plugins built on its plugin API.

---

## Deploy Penpot in Under 5 Minutes

1. Click **Deploy on Railway**. All secrets and passwords are generated for you.
2. Wait for `penpot-backend` to report healthy; the first boot applies database migrations.
3. Open the Penpot domain and choose **Create an account**. Email verification is off, so you land in the dashboard right away.
4. Invite your teammates while registration is open.
5. **Close sign-up:** add `disable-registration` to `PENPOT_FLAGS` on `penpot-backend` and redeploy the three Penpot services.

---

## Important: Sign-Up Is Open at First

This template turns on registration with no email verification so you can create the first account immediately. As long as that stays on, **anyone who finds your URL can create an account**. After your team has joined, replace `enable-registration` with `disable-registration` in `PENPOT_FLAGS` on `penpot-backend`, then redeploy `penpot-backend`, `penpot-frontend` and `penpot-exporter`. Invite new people from inside Penpot after that, and set up SMTP so invitations arrive by email.

---

## Common Use Cases

- **Product design:** design web and mobile apps with components, layouts and prototypes.
- **Design systems:** maintain shared libraries and tokens for every product team.
- **Developer handoff:** give engineers CSS and SVG straight from the design.
- **Agencies:** run separate teams and projects for each client on one server.
- **Open source projects:** collaborate on UI without paid seats for contributors.
- **Regulated industries:** keep unreleased product designs on infrastructure you control.
- **Teaching UI design:** give students a free professional design tool.
- **Wireframes and flows:** sketch user flows and wireframes before detailed design.
- **Marketing assets:** design social images and landing page mockups with shared brand libraries.
- **Client reviews:** share view links so clients comment on designs without buying seats.
- **Accessibility checks:** design with real CSS layout so responsive behavior matches the final product.

---

## Configuration

| Variable | Service | Default | Description |
|---|---|---|---|
| `PENPOT_FLAGS` | backend | registration on, verification off | Feature flags; edit them on penpot-backend |
| `PENPOT_SECRET_KEY` | backend | 🔐 Auto-generated | Master key for sessions and invitations; keep stable |
| `PENPOT_PUBLIC_URI` | frontend | Railway domain | Public URL used everywhere |
| `JAVA_OPTS` | backend | `-Xms256m -Xmx1g` | JVM memory; raise `-Xmx` for very large files |
| `PENPOT_OBJECTS_STORAGE_BACKEND` | backend | `fs` | Stores assets on the backend volume |
| `PENPOT_HTTP_SERVER_MAX_BODY_SIZE` | backend, frontend | 350 MiB | Largest upload accepted |
| `VALKEY_PASSWORD` | Valkey | 🔐 Auto-generated | Valkey password |
| `POSTGRES_PASSWORD` | Postgres | 🔐 Auto-generated | Database password |

**Email.** Add `PENPOT_SMTP_*` variables to `penpot-backend`, such as host, port, username, password and default from address, and add `enable-smtp` to `PENPOT_FLAGS` so invitations and password resets are sent.

**Custom domain.** Add it to `penpot-frontend` in Railway and update `PENPOT_PUBLIC_URI` to the new address, then redeploy the Penpot services.

**Single sign-on.** Penpot supports OpenID Connect, Google, GitHub and GitLab sign-in through additional flags and variables.

**Backups.** Back up Postgres and the backend's `/opt/data/assets` volume together.

**Memory.** The backend is a JVM service; 1 GB of heap suits most teams. Very large files with many boards may need `-Xmx2g` and more service memory. The exporter runs a headless browser and needs a few hundred megabytes while rendering.

**Fonts.** Upload your company fonts in the team settings so every file uses them; they are stored on the backend volume.

**Teams and roles.** Organize people into teams with owner, admin, editor and viewer roles. Viewers can comment and inspect without changing designs, which suits developers and stakeholders.

**Uploads.** The default upload limit is 350 MiB per request, enough for large image libraries and imported files.

**Upgrades.** Images are pinned to 2.18.3. To upgrade, change all three Penpot images to the same newer version and redeploy; migrations run on boot.

---

## Penpot vs. Alternatives

| Feature | Penpot on Railway | Figma Professional | Sketch | Lunacy |
|---|---|---|---|---|
| Hosting | Self-hosted | Hosted SaaS | Mac app plus cloud | Desktop app |
| License | MPL-2.0 | Proprietary | Proprietary | Proprietary |
| Runs in the browser | ✅ | ✅ | ❌ | ❌ |
| Real-time collaboration | ✅ | ✅ | ✅ | ✅ |
| CSS grid and flex layout | ✅ | Auto layout | Stacks | Auto layout |
| Code inspect | ✅ | Dev seat | ✅ | ✅ |
| Price | About $15–30/month total | $16–20/editor/month | Per-editor plans | Free tier |

Figma has the largest plugin and community ecosystem. Sketch suits Mac-only teams. Lunacy is a free desktop app. Penpot is the open source, browser-based option you can host yourself.

---

## Dependencies for Penpot Hosting

- A Railway account.
- Optional: an SMTP provider for invitations and password resets.

### Deployment Dependencies

- [Penpot on GitHub](https://github.com/penpot/penpot): source code and releases
- [Penpot documentation](https://help.penpot.app/): user and self-hosting guides
- [Penpot Docker images](https://hub.docker.com/u/penpotapp): image tags

### Implementation Details

The frontend's nginx reaches the backend, exporter and asset server over Railway's private network and re-resolves their addresses at runtime. Assets are served by the backend from its volume through an internal route.

---

## Frequently Asked Questions

**What is Penpot?**
An MPL-2.0 open source design and prototyping tool that runs in the browser, often used as a Figma alternative.

**How much does it cost to host Penpot?**
About $15–30/month on Railway for all five services, with unlimited editors.

**How do I create the first account?**
Open your Penpot domain and choose Create an account; no email verification is needed.

**How do I stop strangers from signing up?**
Replace `enable-registration` with `disable-registration` in `PENPOT_FLAGS` and redeploy the Penpot services.

**Can I import Figma files?**
Community tools can convert Figma files into Penpot, though complex files may need touch-ups.

**Can developers get code from designs?**
Yes. Inspect mode shows CSS, SVG and HTML for any element.

---

## Why Deploy and Host Penpot on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Penpot on Railway, you get a collaborative design and prototyping tool for your whole team, with your files on your own infrastructure and no per-editor fees.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/penpot-design-tool
