Skip to main content

Deploy NodeBB

Before using the one-click template, here is a minimal Docker Compose file for self-hosting NodeBB.

If you're new to Docker Compose, check out our guide on how to self-host a Docker Compose app. You can also browse more examples in our Docker Compose library.

Self-host NodeBB with Docker Compose (minimal)​

services:
  nodebb:
    image: ghcr.io/nodebb/nodebb:latest
    ports:
      - "4567:4567"
    environment:
      database: postgres
      postgres__host: db
      postgres__port: 5432
      postgres__database: nodebb
      postgres__username: nodebb
      postgres__password: nodebbpass
    volumes:
      - nodebb-data:/var/lib/nodebb

  db:
    image: postgres:15
    environment:
      POSTGRES_DB: nodebb
      POSTGRES_USER: nodebb
      POSTGRES_PASSWORD: nodebbpass
    volumes:
      - dbdata:/var/lib/postgresql/data

volumes:
  nodebb-data:
  dbdata:

Deploy NodeBB on Hostim.dev (One-Click)

NodeBB is a modern, self-hosted forum platform powered by Node.js. It supports PostgreSQL, MongoDB, or Redis databases and utilizes web sockets for real-time interactions. With Hostim.dev, you can deploy NodeBB with Docker and PostgreSQL in one click, fully preconfigured for fast self-hosting.

💬 Create engaging communities with real-time discussions and rich RESTful APIs.

Try it Yourself

Guest project runs for 1 hour. Log in to save and extend to 5 days.

Why Host NodeBB on Hostim.dev?​

  • One-click Docker deployment
  • Built-in PostgreSQL
  • Automatic HTTPS + domain
  • Live logs and metrics
  • Persistent storage

What's included​

ResourceDetails
Appghcr.io/nodebb/nodebb:latest
DatabasePostgreSQL (auto-provisioned)
DomainFree *.hostim.dev subdomain
SSLLet’s Encrypt (auto-enabled)
Port4567
VolumesPersistent storage for NodeBB data

How to Deploy​

  1. Go to your Hostim.dev dashboard.
  2. Click Create Project → Use a Template.
  3. Select NodeBB.
  4. Choose a resource plan.
  5. Deploy.

FAQ​

Where does NodeBB store its data?

Data such as uploads, logs, and internal state is stored in /var/lib/nodebb .

Does NodeBB require PostgreSQL?

NodeBB supports MongoDB, Redis, or PostgreSQL. The Hostim template uses PostgreSQL.

How do I finish the installation?

Visit your site → follow the setup wizard → click “Install”.

How do I configure database credentials?

All DB variables are available under Environment Variables in the dashboard.

Can NodeBB run behind a reverse proxy?

Yes. Ensure url is set correctly in the config after installation.

How do I back up NodeBB?

Back up both the NodeBB data volume and the PostgreSQL database.

Why are websockets not working?

Verify that your reverse proxy preserves WebSocket upgrade headers.

How do I update NodeBB?

Docker: docker compose pull && docker compose up -d Hostim.dev: redeploy the app.

Alternatives​

  • Flarum — PHP-based modern forum
  • Discourse — feature-rich forum with email digestion
  • Lemmy — federated Reddit-style communities

Source + Docs​

Looking for something else? Browse all templates →

Try it now​

Deploy NodeBB Now – in less than 60 seconds