@acuity/directus-extension-acuity-backup 2.1.0 → 2.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +44 -1
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -21,9 +21,12 @@ A powerful Directus bundle extension that provides full or selective backup of c
21
21
 
22
22
  ## Installation
23
23
 
24
+ > ⚠️ **Do not run `npm install @acuity/directus-extension-acuity-backup` directly inside `/directus/extensions`.**
25
+ > That folder is a shared drop-directory, not an npm project root — installing there makes npm scan every sibling extension and can crash with `Cannot read properties of null (reading 'name')`. This extension is **not sandboxed**, so it also cannot be installed from the in-app Directus Marketplace. Use one of the methods below instead.
26
+
24
27
  ### Docker (Recommended)
25
28
 
26
- On your server, inside the directory mounted to `/directus/extensions`:
29
+ On your server, inside the directory mounted to `/directus/extensions`, install the extension into **its own subfolder**:
27
30
 
28
31
  ```bash
29
32
  mkdir acuity-backup && cd acuity-backup
@@ -53,6 +56,46 @@ USER node
53
56
  RUN pnpm install @acuity/directus-extension-acuity-backup
54
57
  ```
55
58
 
59
+ ## Updating
60
+
61
+ ### Docker (subfolder install)
62
+
63
+ To upgrade to the latest published version, clear out the old files and re-extract the new package in the same subfolder:
64
+
65
+ ```bash
66
+ cd /directus/extensions/acuity-backup
67
+ rm -rf dist node_modules package.json package-lock.json icon.png *.tgz
68
+ npm pack @acuity/directus-extension-acuity-backup
69
+ tar -xzf *.tgz --strip-components=1
70
+ rm *.tgz
71
+ npm install --prod
72
+ ```
73
+
74
+ Then restart Directus to load the new version:
75
+
76
+ ```bash
77
+ docker compose restart directus
78
+ ```
79
+
80
+ To pin a specific version instead of the latest, append `@<version>` to the pack command, e.g. `npm pack @acuity/directus-extension-acuity-backup@2.1.0`.
81
+
82
+ ### Dockerfile
83
+
84
+ If you baked the extension into a custom image, update by rebuilding without the cache so the latest version is pulled, then redeploy:
85
+
86
+ ```bash
87
+ docker compose build --no-cache directus
88
+ docker compose up -d directus
89
+ ```
90
+
91
+ Pin a version in the Dockerfile to control upgrades explicitly:
92
+
93
+ ```dockerfile
94
+ RUN pnpm install @acuity/directus-extension-acuity-backup@2.1.0
95
+ ```
96
+
97
+ > Check the installed version anytime with `cat /directus/extensions/acuity-backup/package.json | grep version`, and compare against the [latest release on npm](https://www.npmjs.com/package/@acuity/directus-extension-acuity-backup).
98
+
56
99
  ## Configuration
57
100
 
58
101
  ### Environment Variables
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@acuity/directus-extension-acuity-backup",
3
3
  "description": "Backup Directus collections, schema, and media files to ZIP archives. Provided free, courtesy of Acuity Consulting Inc. — we help companies build smarter systems, automate workflows with AI, and scale with confidence.",
4
4
  "icon": "icon.png",
5
- "version": "2.1.0",
5
+ "version": "2.1.2",
6
6
  "license": "MIT",
7
7
  "author": {
8
8
  "name": "Acuity Consulting Inc.",