Go to file
Tim Schuster b81edff92d
Merge pull request #8 from bryanpedini/master
Update README.md (fix #7)
2020-04-24 15:03:14 +02:00
config Added basis for administration socket 2017-03-17 11:56:20 +01:00
http ignore captcha when creatig new reply 2020-04-22 07:26:29 +02:00
resources Changed "hlandau/passlib.v1" import path (fix #1) 2020-04-16 17:54:54 +02:00
vendor remove unused dep in go.mod, addresses #4 2020-04-21 06:46:59 +02:00
.drone.yml add drone.yml 2020-04-19 10:43:32 +02:00
.gitignore MVP, no mod tools or anything but it works 2017-03-12 20:37:53 +01:00
Dockerfile fixed board server not being on right user and working directory 2020-04-21 19:46:34 +02:00
LICENSE Removed fun from license 2017-03-16 10:46:43 +01:00
README.md Update README.md (fix #7) 2020-04-24 13:49:10 +02:00
config.example.yml implemented Docker, added default configuration 2020-04-21 12:17:44 +02:00
go.mod remove unused dep in go.mod, addresses #4 2020-04-21 06:46:59 +02:00
go.sum remove unused dep in go.mod, addresses #4 2020-04-21 06:46:59 +02:00
main.go inform user of port listening on 2020-04-22 07:24:01 +02:00
screenshot.png Adding Screenshot 2017-03-17 12:36:54 +01:00


nyx - Imageboard

A simple, dependency-free image board.



  • HTTPS Capable Host
  • Being able to compile and run a go binary
  • Disk Space


Simply go get the source code or compile it otherwise, dependencies are included.


By default nyx works in volatile-mode, all changes are only stored in memory and default credentials are setup in the database.

To overwrite these defaults, simply create the file config.yml or specify another file via the -config flag.


Nyx seperates hostnames as distinct namespaces with their own content.

At the moment you cannot port content between namespaces.


The administration panel is available under /admin/ (don't forget the trailing slash), the default login is admin with password admin. It is recommended to add a new administrator and delete the default ID.

Here you can add boards, set board rules and start a database cleanup.

The cleanup will remove entries older than 7 days, deleted and orphaned threads and replies.

Once logged in as administrator you can also delete posts on the setup boards or mark your own posts as special (though still anonymous)


Posts are limited to 10k characters and uploads to 10MB including Base64 overhead (realistically you should be able to upload a 7MB file)

Nyx includes a system called "Trollthrottle". It will rate content based on how well it compresses, it's length and number of lines and the occurence of (currently fixed) keywords.

The end result is a spam score and a captcha probability, both displayed along each post. The captcha probability specifies how like it is that a user will fail a captcha despite having entered it correctly. This is capped at 99%, which means only 1 out of 100 correct solutions will be accepted.

This systems does not stop all trolls but will make it harder for people to post spam by forcing them to do more work.


Tripcodes are non-traditional, they are calculated as the first 8 bytes of the Blake2b Hashsum of the entered Code in Base64 Encoding.

Tripcodes do not offer a guarantee that a user is who they say they are as the codes can be trivially cracked even on a mobile device.


The configuration file is written in YAML.

The following is a list of options available (and supported);

  • secret - Secret used for User Login, CSRF and Session Management, default is changeme
  • listen_on - Defaults to :8080, specifies on which port the HTTP server is launched. Nyx will not utilize this value otherwise so proxying is safe.
  • hosts - A whitelists of hostnames that are allowed to be used. Nyx uses hostnames to differentiate several board collections.
  • db.file - File to use for data storage, defaults to :memory: which means in-memory storage
  • site.title - Site Title
  • site.description - Site Description
  • captcha - Captcha Mode, currently only internal is supported

The config accepts other options but these may not be supported.

Asked Questions

  • Where is the demo?

  • It's available here: https://nyx.demo.bjphoster.com (it resets every 6 hours, it's just to "try and buy" the software, )

  • Where and how is data stored?

  • Nyx uses a KV-Stored called BuntDB. It features in-memory storage and JSON-indexing, Nyx currently only takes advantage of the in-memory storage however. It enables Nyx to operate in "demo mode", leaving no trace on a computer if it's not explicitly configured. Inside the KV Store all data is encoded with JSON.

  • Why no javascript?

  • The lack of Javascript makes Nyx a simple webservice. No public API or complicated authentication. Just Vanilla Go Templates and clean endpoints. I also suck at JS so that helped.

  • Why make an image board?

  • One, there isn't much software out there for this, Wakaba and similar software runs mostly on perl and not on the shared hosting service I use. Nyx is designed to run everywhere without dependencies and without configuration. Secondly, I wanted to see if I could make an imageboard over a weekend, which I succeeded in doing (as you can see).

  • How can I migrate/convert/upgrade the database?

  • The database doesn't migrate old entries, I think that for this application it's more important that new threads and replies work, old data will simply be parse with fallbacks and phased out over time. Currently there is also no way to export or migrate the database, even just between hostnames.


  • Moderation needs to be worked on, currently only global administrators work
  • Video Files might be implemented, though they will most likely require some extra work on the database side, as streaming video from JSON encoded entries will be anything but efficient. The first step would be to enable Nyx to stream content without loading it in memory.
  • MSGPACK encoding instead of JSON
  • More efficient KV usage, images and thumbnails should be moved into seperate entries so that decoding thread and reply data is less costly.
  • Implement Host-Whitelisting more efficiently
  • Manual Hostname Whitelisting (only enable admin panels globally)
  • Global links (kinda like WordPress: "home URL" to be hosted in a subdirectory path, and "board root URL" to "return home" from inside a board)
  • Admin panel refactoring
    • Password change, instead of deleting an entry and re-creating with a different password
    • Board deletion
    • Modern-ish admin panel restyling
  • Database Tool for the following functions:
    • Online & Offline Management
    • Manage Administrators and Moderators
    • Manage Hostnames
    • Manage Boards, Threads and Replies
    • Export / Dump Database
    • Import / Upgrade Database