Registry / storage / strapi-plugin-mongodb-files

strapi-plugin-mongodb-files

library3.1.6jsnpmunverified

A Strapi plugin for storing and serving uploaded files directly in MongoDB using GridFS. Version 3.1.6 supports Strapi v3 (no v4 compatibility). Low maintenance; simple alternative to Strapi's default file plugin when using MongoDB as the only datastore.

storage database

npm install strapi-plugin-mongodb-files

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · STRAPI-PLUGIN-MONG

strapi-plugin-mongodb-files

storagejavascriptv3.1.6

harness data pending

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.

default

✓ const mongodbFiles = require('strapi-plugin-mongodb-files');

✗ import mongodbFiles from 'strapi-plugin-mongodb-files';

CommonJS only; no ES module or named exports.

config

✓ const config = require('strapi-plugin-mongodb-files/config');

✗ import { config } from 'strapi-plugin-mongodb-files';

Configuration is a separate path, not a named export.

plugin

✓ module.exports = { plugins: [{ name: 'mongodb-files', config: require('strapi-plugin-mongodb-files/config') }] };

✗ module.exports = { plugins: ['strapi-plugin-mongodb-files'] };

Must register with config object in Strapi plugins array.

Configures the Strapi MongoDB files plugin with a custom bucket, collection, size limit, and ACL.

// Strapi plugin configuration (./config/plugins.js) module.exports = ({ env }) => ({ 'mongodb-files': { enabled: true, resolve: 'strapi-plugin-mongodb-files', config: { bucketName: 'uploads', collectionName: 'uploads.chunks', maxFileSize: 100 * 1024 * 1024, // 100 MB acl: 'public-read', }, }, }); // Usage: upload via Strapi admin or API, files stored in GridFS.

Debug

Known issues

breakingPlugin only works with Strapi v3.x; incompatible with Strapi v4+.

fix

Use Strapi v3 or switch to a v4-compatible file provider (e.g., @strapi/provider-upload-local).

affects: >=4.0.0

deprecatedPlugin uses Mongoose GridFS; Strapi v3 encourages stream-based providers. This plugin may not receive updates.

fix

Consider migrating to Strapi's built-in upload provider or an actively maintained alternative.

affects: >=0.0.0

gotchaFiles are stored as GridFS files; cannot bypass Strapi's upload middleware for direct access.

fix

Always upload and retrieve files via Strapi's API (e.g., /upload).

affects: >=0.0.0

gotchaWhen deleting a file, GridFS orphan chunks may remain if deletion fails.

fix

Implement a cleanup job to remove orphaned chunks or use Strapi's built-in delete with proper error handling.

affects: >=0.0.0

gotchaBucket name and collection name must match existing GridFS collections or be created manually.

fix

Ensure the MongoDB user has write access to create collections; plugin doesn't auto-create on first use.

affects: >=0.0.0

Errors

Common errors & fixes

Cannot find module 'strapi-plugin-mongodb-files'

Plugin not installed or not resolved correctly in Strapi.

fix

npm install strapi-plugin-mongodb-files && verify ./config/plugins.js has correct resolve path.

Invalid or unexpected token (in plugin config)

Syntax error when using ES6 imports in CommonJS Strapi config.

fix

Use module.exports with require() instead of import/export.

MongoError: bucket name may not contain '.'

Bucket name contains a period, which is invalid for MongoDB GridFS.

fix

Use a bucket name without dots (e.g., 'uploads').

Upgrade

Version history

3.1.6latest on npm

Audit

Dependencies

strapirequiredPlugin extends Strapi's file upload mechanism.

mongooserequiredUnderlying driver for MongoDB operations.

Agent activity

45 hits · last 30 days

node