gochan/gochan
1
0
Fork 0
mirror of https://github.com/Eggbertx/gochan.git synced 2025-08-09 20:26:24 -07:00
Code Releases Activity
No description
433 commits 5 branches 55 tags 21 MiB
Find a file
user.email 4fa467933b use QR file input when posting, improve front page formatting
2018-12-04 15:38:19 -08:00
html use QR file input when posting, improve front page formatting 2018-12-04 15:38:19 -08:00
sass use QR file input when posting, improve front page formatting 2018-12-04 15:38:19 -08:00
src Add QR box 2018-12-03 12:34:36 -08:00
templates use QR file input when posting, improve front page formatting 2018-12-04 15:38:19 -08:00
vagrant Move page building functions to building.go 2018-10-22 11:01:51 -07:00
.gitignore Don't track .bak (temporary backup) files 2018-07-15 07:35:34 -07:00
dist.sh remove Version field from config struct to avoid JSON parsing issues 2018-11-26 15:29:26 -08:00
gochan-fastcgi.nginx Fix issue with nginx starting before the vagrant shared directory is mounted 2018-02-02 13:01:34 -08:00
gochan-http.nginx Fix issue with nginx starting before the vagrant shared directory is mounted 2018-02-02 13:01:34 -08:00
gochan.example.json Change config.Styles from a string array to a Style struct array and give proper warning 2018-12-01 12:13:33 -08:00
gochan.service Add systemd service, subject field autocomplete prevention 2018-05-29 11:38:33 -07:00
initialsetupdb.sql Move page building functions to building.go 2018-10-22 11:01:51 -07:00
LICENSE Add post editing, fix log not showing IP/path 2018-06-09 23:40:20 -07:00
Makefile remove Version field from config struct to avoid JSON parsing issues 2018-11-26 15:29:26 -08:00
README.md Rewrite CSS as Sass (.scss) files for better organization/loading 2018-11-25 14:16:22 -08:00
ROADMAP.md Update roadmap with configuration, update version in static error pages 2018-08-09 00:08:29 -07:00
version Add QR box 2018-12-03 12:34:36 -08:00

README.md

Gochan

A semi-standalone imageboard server written in Go

http://gochan.org

Installation

Basic installation (from a release)

  1. Extract the .tar.gz or the .zip file into a directory (for example, your home directory)
  2. Copy gochan.example.json to gochan.json and modify it to your liking.
    1. If you want to see debugging info/noncritical warnings, set verbosity to 1. If you want to see benchmarks as well, set it to 2.
    2. Make sure to set DBname, DBusername, and DBpassword, since these are required to connect to your MySQL database. Set DomainRegex,SiteDomain, since these are necessary in order to post and log in as a staff member without being rejected.
  3. If you're using nginx, copy gochan-fastcgi.nginx, or gochan-http.nginx if UseFastCGI is set to true to /etc/nginx/sites-enabled/, or the appropriate folder in Windows.
  4. If you're in Linux, you can optionally copy gochan.service to ~/.config/systemd/user/gochan.service and run systemctl enable gochan.service to have it run on login and systemctl start gochan.service to start it as a background service.
    1. If you aren't using a distro with systemd, you can start a screen session and run ./gochan
  5. Go to http://[gochan url]/manage?action=boards, log in (default username/password is admin/password), create a board, and go to http://[gochan url]/manage?action=rebuildall
    1. For security reasons, you should probably go to http://[gochan url]/manage?action=staff to create a new admin user account and delete admin.

For developers (using Vagrant)

  1. Install Vagrant and Virtualbox. Vagrant lets you create a virtual machine and run a custom setup/installation script to make installation easier and faster.
  2. From the command line, cd into vagrant/ and run vagrant up
  3. After it finishes installing the Ubuntu VM, follow the printed instructions.

Theme development

See sass/README.md for information on working with Sass and stylesheets.