Registry /
storage / ghost-storage-cloudinary
Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CloudinaryAdapter
✓ const CloudinaryAdapter = require('./path/to/ghost-storage-cloudinary');
✗ import CloudinaryAdapter from 'ghost-storage-cloudinary';
This adapter is loaded by Ghost using CommonJS require() at runtime. Do not import in application code.
Ghost Storage Config
✓ storage: { active: 'ghost-storage-cloudinary', 'ghost-storage-cloudinary': { auth: {}, upload: {}, fetch: {} } }
✗ storage: { active: 'cloudinary' }
The active adapter name must match the folder name: 'ghost-storage-cloudinary'.
Ghost CLI Config Command
✓ ghost config storage.active ghost-storage-cloudinary
✗ ghost config storage.active cloudinary
CLI config uses the full adapter name.
Installation and configuration of Ghost to use Cloudinary storage adapter.
// Step 1: Install and move to content/adapters/storage/ghost-storage-cloudinary
// Step 2: Configure Ghost config.json
{
"storage": {
"active": "ghost-storage-cloudinary",
"ghost-storage-cloudinary": {
"auth": {
"cloud_name": process.env.CLOUDINARY_CLOUD_NAME ?? '',
"api_key": process.env.CLOUDINARY_API_KEY ?? '',
"api_secret": process.env.CLOUDINARY_API_SECRET ?? ''
},
"upload": {
"use_filename": true,
"unique_filename": false,
"overwrite": false
},
"fetch": {
"quality": "auto"
}
}
},
"imageOptimization": false
}
Errors
Common errors & fixes
ENOENT: no such file or directory, open '.../content/adapters/storage/ghost-storage-cloudinary/index.js'
The adapter was not moved to the correct location.
fixRun: mv node_modules/ghost-storage-cloudinary content/adapters/storage/ghost-storage-cloudinary
ConfigurationError: The 'storage' config must have an 'active' property.
Missing or invalid storage configuration in config.json.
fixAdd 'storage.active': 'ghost-storage-cloudinary' to Ghost config.
Error: Must supply cloud_name
Missing Cloudinary authentication credentials.
fixSet auth config or CLOUDINARY_URL environment variable.
Audit
Dependencies
ghostrequiredRuns as a Ghost storage adapter
cloudinaryrequiredCloudinary Node.js SDK for API calls