Real-time imageboard in node.js and redis
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Lal'C Mellk Mal 9796109ea6 Fix upkeep/clean.js 1 week ago
admin Use more arrow functions 2 months ago
archive pipeline.js: use promises 3 months ago
client "Only upload images" option 1 month ago
curfew Remove `hook_sync` and `trigger_sync` 3 months ago
docs nofollow noopener noreferrer 3 years ago
imager Log imager errors when standalone 1 week ago
lib Remove yepnope 3 years ago
lua Use active posts from Lua 3 years ago
report Nodemailer 6.4.10 4 months ago
server Fix 303.js redirect hang 1 week ago
tmpl Modernize tmpl JS 1 month ago
tripcode Port tripcode to NAPI 4 months ago
upkeep Fix upkeep/clean.js 1 week ago
www sockjs client 1.4.0; force ws or xhr-streaming 4 months ago
.gitignore Document spoiler images 2 months ago
.ignore Don't grep minified JS 3 years ago
LICENSE Update copyright year to 2020 2 months ago
Makefile New script-building pipeline 7 years ago Document spoiler images 2 months ago
TODO Inline/remove remaining hooks 2 months ago
builder.js New script-building pipeline 7 years ago
common.js Use config prefix in client code 2 months ago
config.js.example sockjs client 1.4.0; force ws or xhr-streaming 4 months ago
db.js Async commit_image_alloc 2 months ago
deps.js Inline/remove remaining hooks 2 months ago
etc.js Patch Muggle.deepest_reason 1 week ago
hot.js.example Hackily fade inserted images in 2 years ago
make_client.js Provide async exec, execFile 1 month ago
package.json Bump node-fetch from 2.6.0 to 2.6.1 (#126) 1 month ago
pipeline.js async make_client 2 months ago
tail.js Use setImmediate in tail 7 years ago

Real-time imageboard. MIT licensed.


  • Install dependencies listed below
  • Sign up for reCAPTCHA
  • Create a GitHub Application (callback URL = site URL + /login)
  • Copy config.js.example to config.js and configure
  • Copy hot.js.example to hot.js and configure
  • Copy imager/config.js.example to imager/config.js and configure
  • Copy report/config.js.example to report/config.js and configure
  • Clone assets and copy the kana spoiler image folder as ./www/kana/ (or create your own!).
  • Run npm install to install npm deps and compile a few helpers
  • Run node builder.js to run an auto-reloading development server


  • Have your webserver serve www/ (or wherever you’ve moved src, thumb, etc.)
    • Configure imager.config.MEDIA_URL appropriately
  • If you’re behind Cloudflare turn on CLOUDFLARE
    • Or if you’re behind any reverse proxy (nginx etc) turn on TRUST_X_FORWARDED_FOR
  • Run node server/server.js for just the server
  • You can update client code & hot.js on-the-fly with node server/kill.js
  • For nginx hosting/reverse proxying, refer to docs/nginx.conf.example
  • For a sample init script, refer to docs/doushio.initscript.example
  • config.DAEMON support is old and broken, PRs welcome


  • ImageMagick
  • libpng
  • node.js + npm
  • npm install -g node-gyp
  • redis
  • ffmpeg 2.2+ if supporting WebM
  • jhead and jpegtran optionally, for EXIF autorotation

Optional npm deps for various features:

  • daemon (broken currently)
  • send (if you want to serve static files directly from the node.js process; useful in debug mode also)

Standalone upkeep scripts:

  • archive/daemon.js - moves old threads to the archive
  • upkeep/backup.js - uploads rdb to S3
  • upkeep/clean.js - deletes archived images