anonymous realtime imageboard focused on high performance, free speech and transparent moderation
Platforms: Linux, OSX
License: GNU AGPL
- PostgresSQL >= 10.0
For installing meguca directly onto a server follow the steps bellow.
A reference list of commands can be found in ./docs/installation.md
- Go >=1.11 (for building server)
- Node.js >=5.0 (for building client)
- C11 compiler
- make
- pkg-config
- pthread
- ffmpeg >= 3.1 libraries (libavcodec, libavutil, libavformat, libswscale)
compiled with:
- libvpx
- libvorbis
- libopus
- libtheora
- libx264
- libmp3lame
- OpenCV >= 2
- libgeoip
- git
- Run
make
Meguca can be deployed in a self-contained Docker container. Install Docker and run
docker build -t meguca .
docker run -t -p 8000:8000 meguca
meguca can be started in debug mode simply with ./meguca
.
Configurations are split between meguca instance configurations
and server instance configurations, which are required to start
the server and connect to the database.
The meguca instance configurations are stored in the database, but
server instance configurations are optionally loaded from a config.json
file on server start.
A sample configuration file can be found under docs/config.json
.
Documentation for this file is available under docs/config.jsonc
.
It is recommended to serve meguca behind a reverse proxy like NGINX or Apache
with properly configured TLS settings. A sample NGINX configuration file can be
found in docs/
.
- Login into the "admin" account via the infinity symbol in the top banner with the password "password"
- Change the default password
- Create a board from the administration panel
- Configure server from the administration panel
- See
./docs
for more documentation make server
andmake client
build the server and client separatelymake watch
watches the file system for changes and incrementally rebuilds the clientmake clean
removes files from the previous compilationmake {test,test_no_race,test_docker}
run regular, without data race detection and Dockerized test suites, respectively- To run server unit tests (unless Dockerized) add database creation rights to your PostgreSQL role