Public | Automated Build

Last pushed: 2 years ago
Short Description
NodeBB is a fast and powerful forum built with nodejs
Full Description

NodeBB is built with nodejs, and is made to be fast and powerful. For your convenience, we currently offer CentOS and Ubuntu builds.


To get started with running NodeBB using Docker, you will want to run a redis instance.

docker run --name my-forum-redis -d -p 6379:6379 nodebb/docker:centos-redis
docker run --name my-forum-redis -d -p 6379:6379 nodebb/docker:ubuntu-redis

Next, launch the NodeBB instance, so it links with the just-launched Redis instance.

docker run --name dockerdev-nodebb --link dockerdev-redis:redis -p 80:80 -p 443:443 -p 4567:4567 -P -t -i nodebb/docker:centos

docker run --name dockerdev-nodebb --link dockerdev-redis:redis -p 80:80 -p 443:443 -p 4567:4567 -P -t -i nodebb/docker:ubuntu 

You will be asked to configure your NodeBB instance, as no config file was found. Simply press enter for all settings except Redis hostname, which should be redis as it is linked using the --linked parameter to our Redis instance, and the administrator username, e-mail and password.

The default port of nodebb is 4567. Ports 80, and 443 have also been exposed for your convenience. You can keep the default nodebb port or change it.

NodeBB will launch the setup and automatically close. Next, simply start the instance again. It will this time find a config file and start as a daemon.

docker start my-forum-nodebb

Your NodeBB instance will be accessible on the port you selected during setup. Check docker ps for more details.


Simply use the /data volume inside your Redis instance. See the official guide on making backups.

Docker Pull Command
Source Repository

Comments (6)
8 months ago

Thank you for this! I am not using this specific image but the components you used to build it were helpful to me while trouble shooting.

2 years ago

Hello !

Thanks for this repo. But if I understand right (I asked on the official NodeBB forum) this is not an official repo created by the official team ?

Whatever, it's very usefull ! But, can you put it up-to-date please ? :)

2 years ago

For some reason you need to specify the port of the host in the url parameter.

URL used to access this NodeBB (http://localhost:4567):
2 years ago

When I run Nodebb:

docker run --name nodebb --link nodebb-redis:redis -p 80:80 -p 443:443 -p 4567:4567 -P -t -i nodebb/docker:ubuntu

I got:

docker run --name nodebb --link nodebb-redis:redis -p 80:80 -p 443:443 -p 4567:4567 -P -t -i nodebb/docker:ubuntu
3/5 15:28 [1] - info: NodeBB v0.6.1 Copyright (C) 2013-2014 NodeBB Inc.
3/5 15:28 [1] - info: This program comes with ABSOLUTELY NO WARRANTY.
3/5 15:28 [1] - info: This is free software, and you are welcome to redistribute it under certain conditions.
3/5 15:28 [1] - info:
3/5 15:28 [1] - warn: Configuration not found, starting NodeBB setup
3/5 15:28 [1] - info: Welcome to NodeBB!
3/5 15:28 [1] - info: This looks like a new installation, so you'll have to answer a few questions about your environment before we can proceed.
3/5 15:28 [1] - info: Press enter to accept the default setting (shown in brackets).
URL used to access this NodeBB (http://localhost:4567)
Please enter a NodeBB secret (03c99b8d-ff9f-4ae2-9b23-514426828b56)
Which database to use (redis) redis

3/5 15:29 [1] - info: Now configuring redis database:
Host IP or address of your Redis instance (
Host port of your Redis instance (6379)
Password of your Redis database
Which database to use (0..n) (0)
3/5 15:29 [1] - info: Configuration Saved OK
npm WARN package.json nodebb-plugin-dbsearch@0.1.1 No repository field.
redis@0.10.3 node_modules/redis

connect-redis@2.0.0 node_modules/connect-redis
└── debug@2.1.3 (ms@0.7.0)
3/5 15:29 [1] - info: Populating database with default configs, if not already set...
3/5 15:29 [1] - error: Error: Redis connection to failed - connect ECONNREFUSED
    at RedisClient.flush_and_error (/opt/nodebb/node_modules/redis/index.js:142:13)
    at RedisClient.on_error (/opt/nodebb/node_modules/redis/index.js:180:10)
    at Socket.<anonymous> (/opt/nodebb/node_modules/redis/index.js:95:14)
    at Socket.EventEmitter.emit (events.js:95:17)
    at net.js:441:14
    at process._tickCallback (node.js:415:13)
3/5 15:29 [1] - warn: NodeBB Setup Aborted. Redis connection to failed - connect ECONNREFUSED
2 years ago

Hi Leemy,
Just pushed out an update to the Dockerfile to grab from the 0.6.x branch.

3 years ago

Hi, I just ran NodeBB using Docker successfully and found it is NodeBB v0.5.4. How can I get a newer version of Dockerfile, such as v0.6.1 or v.0.7.X? Thanks~