[ prog / sol / mona ]

sol


Installing SchemeBBS for the absolute beginner

1 2020-05-21 00:49

hi, is there a manual to install scheme bbs for the complete newbie? i know how to install wordpress, etc, if that info is useful (probably because they have step by step instructions.)

i like the simplicity of this bbs' setup, better than kareha. thanks.

2 2020-05-21 00:54

Fetch MIT/GNU Scheme 9.2, apply the patches and build it. Checkout the repo, create boards, [nginx magic goes here], load bbs.scm. Et voilà!,

3 2020-05-21 01:27

that was very quick, albeit not very useful for a newbie like me. ^_^; could you be a little gentle to a novice?

4 2020-05-21 10:58 *

>>3
What OS are you using?

5 2020-05-22 03:57

>>4 Amazon Linux

6 2020-05-22 03:58

wait, i think i can hack my way through this...

7 2020-05-22 07:22

>>5
Use the Docker image.

8 2020-05-22 08:23

i'll try that, thanks

9 2020-05-22 11:06

>>5
Do what >>7 says, it's the easiest way.

Amazon Linux doesn't package mit-scheme (neither does CentOS I think)
The complete install below.

# install MIT Scheme binary
wget https://ftp.gnu.org/gnu/mit-scheme/stable.pkg/9.2/mit-scheme-9.2-x86-64.tar.gz
tar xzvf mit-scheme-9.2-x86-64.tar.gz
mv mit-scheme-9.2 mit-scheme-9.2-binary
cd mit-scheme-9.2-binary/src
./configure
make
sudo make install
cd ../../

# Patch the source of MIT Scheme and reinstall the patched version
wget https://ftp.gnu.org/gnu/mit-scheme/stable.pkg/9.2/mit-scheme-9.2.tar.gz
wget https://gitlab.com/naughtybits/schemebbs/-/raw/master/patch-runtime_http-syntax.scm
patch -p0 < patch-runtime_http-syntax.scm
cd mit-scheme-9.2/src
./configure
make
sudo make install
cd ../../

# run SchemeBBS
git clone https://github.com/alyssa-p-hacker/SchemeBBS.git
cd schemebbs
./create-boards.sh lolicon
./init.sh 8080

Then visit http://yourhost:8080/lolicon and make your first post.

10 2020-05-22 12:20 *

nice! i’ll try this over the weekend. thanks anon

11 2020-05-25 23:59 *

>>9 can you share you nginx config settings?

12 2020-05-30 09:44

>>11
It was posted here: http://textboard.org/prog/39/143
It's also integrated in the docker-schemebbs-nginx project
https://github.com/TeamWau/docker-schemebbs-nginx/blob/master/nginx.conf
Install Docker, type

docker pull erkin/schemebbs-nginx

and you're all set.

13 2020-05-30 11:53 *

arigato sensei, i'll give this a try ^_^;

14 2020-05-30 20:15 *

>>13
Thank TeamWau, they did all the work. Create your boards, add a domain name and type the line below: SchemeBBS is deployed and ready to serve.

15 2020-05-30 23:46 *

arigato teamwau ^_^;

16 2020-05-31 11:44 *

managed to install using erkin/schemebbs-nginx but now i get 502 errors when i click on [post] after typing my message.

17 2020-06-01 17:53

So is it going to be open to the public?

18 2020-06-02 02:25 *

>>14 >add a domain name and type the line below
domain name into the nginx.conf, right? what does type the line below mean?

19 2020-06-02 07:48 *

>>18
Dude... >>14 probably forgot to copy and paste the instructions in the README. That's the line.

20 2020-06-02 08:45 *

thanks mate! apologies for being so programmatically challenged. ^_^;

21 2020-06-02 12:37 *

>>20
Keep us posted when you deploy it and make some boards.

22 2020-06-02 15:43

>>20
It's ok, just don't give up!

Don't forget to clone the github repo. I've repeated the steps to be sure and you should be all set up if you do this:

1. clone the repo and edit nginx.conf

git clone https://github.com/TeamWau/docker-schemebbs-nginx.git
cd docker-schemebbs-nginx
vi nginx.conf

Find those lines:

30    server {
31        listen 80;
32        server_name _; # Put your own domain here

That's where you'll input your domain name obviously. You can put any domain name, even if you don't own it if you edit /etc/hosts accordingly. Otherwise it will certaninly work on the domain localhost.

2.create your first boards, and launch the Docker image

./create-boards rockstacking travel tennis
export SBBS_DATADIR=/opt/bbs
docker run -p 80:80 --name sbbs -d -v "${SBBS_DATADIR}":/opt/schemebbs/data -v "$(pwd)"/nginx.conf:/opt/nginx/conf/nginx.conf erkin/schemebbs-nginx

You will probably need to run the last commands as root. (it's Docker's default install I think)

23 2020-06-02 16:34 *

Also the README has been updated if you want to take the long way and install everything by yourself. It may pay off for deployment on a machine with limited resources.

https://gitlab.com/naughtybits/schemebbs

24 2020-06-02 17:29

>>23
The export command should precede create-boards.sh because the modified version overrides $DATADIR with $SBBS_DATADIR.

Unrelatedly; it would be nice if the CSS automatically defaulted to dark.css instead of default.css according to the user's theme preference. (See: prefers-color-scheme)

25 2020-06-02 23:17 *

>>24
I'm no web designer, I only modified a couple of colors in the default.css file, taking inspiration from what the (ungoogled)chromium addon Dark Mode was rendering. I have a friend who's losing his sight and oddly enough he can only see web pages in low contrast settings. I always thought it was some kind of a hipster trend. He's not visiting the site but I made it thinking of him.

If you overwrite default.css with dark.css the site will be dark by default. But really the stylesheet should be the responsability of the user, like the display fonts and even the whole browsing experience (there are userscripts that change that already and the best browser IMNSHO is an Emacs mode)
Also note that there's no limit to the number of stylesheets you can add. the query ?style=foo will fetch foo.css and the query string ?style=whatever will fetch whatever.css/

The SchemeBBS draft included the possiblity to post your own CSS file in code blocks in a regular thread and use that. It has yet to be implemented, I went timeout and had to cut non vital features, back then.

I will add other preferences that were planned though, like the optional header inlined thread list so that an instance can have the complete look and feel of good ole 2channel if a user wants that.

I want to leave the default as it is(*). SchemeBBS was supposed to look almost unnoticeably different from a site without CSS at all. That's in the official specs from the SchemeBBS consortium along with: no cookies, no Javascript, compatiblity with HTML 2.0 and html5, no <DIV> (don't ask why), get the same identation and look in text-mode browsers like elinks, no clutter for screen readers for blind people, no class attributes (failed at that one), HTML source as human readable as possible, and so on...

(*) But I began to use dark.css on the web browser myself so there's a chance I change my mind soon.

26 2020-06-03 01:12 *

thanks for all the work you've done and for the detailed instructions! i'll give it a try this weekend!

27 2021-07-31 23:25

Progress Report: Status Update?

28 2021-07-31 23:51

Aborted.

29 2021-08-17 12:50

Sorry about that, I couldn't make it work. Imma give it another go. ≧Д≦)

30 2022-04-07 11:21

Updates? Im trying to get my board up and running too but im having problems with docker spitting out errors and tbh I have no clue what im doing in regards with the nginx parts.

31


VIP:

do not edit these