From a3381b4880c8fdbd3b82678ff7684d09e3748dae Mon Sep 17 00:00:00 2001
From: Yamila Moreno <yamila.ms@gmail.com>
Date: Fri, 31 Jan 2025 16:05:04 +0100
Subject: [PATCH] :whale: Use the same PENPOT_VERSION envvar for all penpot
 services

---
 docker/images/docker-compose.yaml       |  6 +++---
 docs/technical-guide/getting-started.md | 11 +++++++++++
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/docker/images/docker-compose.yaml b/docker/images/docker-compose.yaml
index 64471320e..aa215f36c 100644
--- a/docker/images/docker-compose.yaml
+++ b/docker/images/docker-compose.yaml
@@ -72,7 +72,7 @@ services:
   #     - "443:443"
 
   penpot-frontend:
-    image: "penpotapp/frontend:latest"
+    image: "penpotapp/frontend:${PENPOT_VERSION:-latest}"
     restart: always
     ports:
       - 9001:8080
@@ -115,7 +115,7 @@ services:
       << : [*penpot-flags, *penpot-http-body-size]
 
   penpot-backend:
-    image: "penpotapp/backend:latest"
+    image: "penpotapp/backend:${PENPOT_VERSION:-latest}"
     restart: always
 
     volumes:
@@ -205,7 +205,7 @@ services:
       PENPOT_SMTP_SSL: false
 
   penpot-exporter:
-    image: "penpotapp/exporter:latest"
+    image: "penpotapp/exporter:${PENPOT_VERSION:-latest}"
     restart: always
 
     depends_on:
diff --git a/docs/technical-guide/getting-started.md b/docs/technical-guide/getting-started.md
index 88f0dbbdf..2790e90be 100644
--- a/docs/technical-guide/getting-started.md
+++ b/docs/technical-guide/getting-started.md
@@ -175,6 +175,17 @@ docker compose -p penpot -f docker-compose.yaml up -d
 
 At the end it will start listening on http://localhost:9001
 
+<p class="advice">
+    If you don't change anything, by default this will use the latest image published in dockerhub.
+</p>
+
+If you want to have more control over the version (which is recommended), you can use the PENPOT_VERSION envvar in the common ways:
+- setting the value in the .env file
+- or passing the envvar in the command line
+
+```bash
+PENPOT_VERSION=2.4.3 docker compose -p penpot -f docker-compose.yaml up -d
+```
 
 ### Stop Penpot