specify docker project name in compose projects

Author: stevensJourney

examples/self-hosted/local-basic-supabase/powersync/docker/docker-compose.yaml

@@ -2,14 +2,17 @@
 # Modules add entries to include and to services.powersync.depends_on.
 # Relative paths: . = powersync/docker, .. = powersync.
 # Include syntax requires Docker Compose v2.20.3+
+# name: ensures unique volumes per project when switching between projects
+
+name: powersync_local-basic-supabase
 
 include: []
 
 services:
   powersync:
     restart: unless-stopped
     image: journeyapps/powersync-service:latest
-    command: [ 'start', '-r', 'unified' ]
+    command: ["start", "-r", "unified"]
     env_file:
       - .env
     volumes:
@@ -20,15 +23,15 @@ services:
       NODE_OPTIONS: --max-old-space-size=1000
     healthcheck:
       test:
-        - 'CMD'
-        - 'node'
-        - '-e'
+        - "CMD"
+        - "node"
+        - "-e"
         - "fetch('http://localhost:${PS_PORT:-8080}/probes/liveness').then(r =>
           r.ok ? process.exit(0) : process.exit(1)).catch(() =>
           process.exit(1))"
       interval: 5s
       timeout: 1s
       retries: 15
     ports:
-      - '${PS_PORT:-8080}:${PS_PORT:-8080}'
+      - "${PS_PORT:-8080}:${PS_PORT:-8080}"
     depends_on: {}

examples/self-hosted/local-postgres-node/powersync/docker/docker-compose.yaml

@@ -2,6 +2,9 @@
 # Modules add entries to include and to services.powersync.depends_on.
 # Relative paths: . = powersync/docker, .. = powersync.
 # Include syntax requires Docker Compose v2.20.3+
+# name: ensures unique volumes per project when switching between projects
+
+name: powersync_local-postgres-node
 
 include:
   - ./modules/database-postgres/postgres.database.compose.yaml

examples/self-hosted/local-postgres/powersync/docker/docker-compose.yaml

@@ -2,18 +2,21 @@
 # Modules add entries to include and to services.powersync.depends_on.
 # Relative paths: . = powersync/docker, .. = powersync.
 # Include syntax requires Docker Compose v2.20.3+
+# name: ensures unique volumes per project when switching between projects
+
+name: powersync_local-postgres
 
 include:
   [
     modules/database-postgres/postgres.database.compose.yaml,
-    modules/storage-postgres/postgres.storage.compose.yaml
+    modules/storage-postgres/postgres.storage.compose.yaml,
   ]
 
 services:
   powersync:
     restart: unless-stopped
     image: journeyapps/powersync-service:latest
-    command: [ 'start', '-r', 'unified' ]
+    command: ["start", "-r", "unified"]
     env_file:
       - .env
     volumes:
@@ -24,19 +27,19 @@ services:
       NODE_OPTIONS: --max-old-space-size=1000
     healthcheck:
       test:
-        - 'CMD'
-        - 'node'
-        - '-e'
+        - "CMD"
+        - "node"
+        - "-e"
         - "fetch('http://localhost:${PS_PORT:-8080}/probes/liveness').then(r =>
           r.ok ? process.exit(0) : process.exit(1)).catch(() =>
           process.exit(1))"
       interval: 5s
       timeout: 1s
       retries: 15
     ports:
-      - '${PS_PORT:-8080}:${PS_PORT:-8080}'
+      - "${PS_PORT:-8080}:${PS_PORT:-8080}"
     depends_on:
       {
         pg-db: { condition: service_healthy },
-        pg-storage: { condition: service_healthy }
+        pg-storage: { condition: service_healthy },
       }

plugins/docker/src/commands/docker/configure.ts

@@ -128,6 +128,8 @@ export default class DockerConfigure extends SelfHostedInstanceCommand {
         ].join('\n');
     }
 
+    const projectName = composeProjectName(projectDirectory);
+    mainComposeDocument.set('name', projectName);
     writeFileSync(path.join(targetDockerDir, 'docker-compose.yaml'), stringify(mainComposeDocument), 'utf8');
 
     // Persist environment config
@@ -136,8 +138,6 @@ export default class DockerConfigure extends SelfHostedInstanceCommand {
     // Set api.tokens in service.yaml for local dev (same token as in link)
     serviceConfigDocument.set('api', { tokens: [DEV_TOKEN] });
     writeFileSync(path.join(projectDirectory, SERVICE_FILENAME), stringify(serviceConfigDocument), 'utf8');
-
-    const projectName = composeProjectName(projectDirectory);
     updateLinkPluginsDocker(projectDirectory, projectName);
 
     this.log(ux.colorize('green', `Configured ${targetDockerDir}`));