ImgLink for NodeBB
The ImgLink NodeBB plugin is a pure Node.js 18+ implementation that requires zero npm dependencies. It uses the native fetch API, FormData, and Blob with fs.readFileSync to upload images to /api/v1/upload. The plugin exports a simple async upload() function for NodeBB's plugin hooks, with AbortSignal timeout support and a configurable retry loop. Includes plugin.json metadata for NodeBB's plugin manager. Tested on Node.js 22 in CI.
Requirements
- Node.js 18 or higher
- NodeBB 3.x
- ImgLink API key (free)
- No npm packages needed
Modern communities, gaming guilds, tech forums
What's included
Installation Guide
Follow these steps to integrate ImgLink with NodeBB.
Copy to NodeBB plugins/
Copy the plugin folder into NodeBB's node_modules or plugins directory.
cp -r ./nodebb-plugin-imglink /path/to/nodebb/node_modules/
Activate in ACP
In NodeBB ACP → Extend → Plugins, find imglink and click Activate.
Configure credentials
Set your API key in NodeBB's ACP settings panel or in config.json.
{
"apiBase": "https://imglink.cc",
"apiKey": "YOUR_KEY_HERE",
"timeoutSeconds": 30,
"retries": 3
}Verify the upload hook
Post an image and confirm the URL points to the imglink.cc CDN.
const result = await plugin.upload(filePath, config); console.log(result.url); // https://imglink.cc/cdn/...
Why host images on ImgLink?
Global CDN
Images served from a global edge network. Sub-100ms load times. No bandwidth cost to your forum server.
Scoped API Keys
One API key per forum. Revoke or rotate instantly. Keys never leave your config file — never hardcoded.
Retry Safety
Exponential backoff on every upload. Images never fail silently — retries handle transient network issues.
Ready to deploy ImgLink on NodeBB?
Download the plugin, add your API key, and go live in under 10 minutes. Free to use — no credit card required.
