~krystianch/buyfriend

Local ads for you, your family, friends or coworkers

24b9b7f Add contributing

2 months ago

69ee0bc Add production deployment info

7 months ago

#buyfriend

Web service for local ads.

Live demo available at https://demo.buyfriend.org/.

Screenshot

#Running (development)

flask --app buyfriend init-db
flask --app buyfriend create-user user@localhost "User Name"
flask --app buyfriend run

#Deploying (production)

We recommend to use Alpine Linux, NGINX and Gunicorn to serve buyfriend in production environments.

Buyfriend is available in a third party package repository: alpine.krystianch.com. You'll need to add it (refer to the link above for instructions) in order to install buyfriend from the package manager.

doas apk add nginx gunicorn buyfriend

Create socket and instance directories and give ownership to the buyfriend user.

doas mkdir -p /var/run/buyfriend /var/lib/buyfriend
doas chown buyfriend:buyfriend /var/run/buyfriend /var/lib/buyfriend

Use the following NGINX configuration. Replace demo.buyfriend.org with your domain.

server {
	listen 80 default_server;
	listen [::]:80 default_server;

	location / {
		return 302 https://$host$request_uri;
	}

	location ^~ /.well-known {
		root /var/www;
	}
}

server {
	listen 443 ssl http2;
	listen [::]:443 ssl http2;
	server_name demo.buyfriend.org;
	ssl_certificate /etc/ssl/uacme/demo.buyfriend.org/cert.pem;
	ssl_certificate_key /etc/ssl/uacme/private/demo.buyfriend.org/key.pem;

	location / {
		error_page 502 /502.html;

		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
		proxy_set_header Host $http_host;
		proxy_redirect off;
		proxy_pass http://unix:/var/run/buyfriend/buyfriend.sock;
	}

	location /photos {
		root /var/lib/buyfriend/;
		expires 1d;
	}

	location /static {

		# Keep me up to date
		root /usr/lib/python3.11/site-packages/buyfriend/;

		gzip_types text/css;
		expires 1h;
	}

	location = /502.html {
		internal;
		return 502 "Site temporarily unavailable. Please try again in a moment.";
	}
}

Edit /etc/conf.d/buyfriend:

BUYFRIEND_USER=buyfriend
BUYFRIEND_BIND="unix:/var/run/buyfriend/buyfriend.sock"
BUYFRIEND_GUNICORN_ARGS="--worker-class gevent --workers 2 --keep-alive 5"

export BUYFRIEND_LOG_LEVEL=INFO  # set log level early to see config loading logs
#export BUYFRIEND_CONFIG=/etc/buyfriend/buyfriend.toml  # default value

Edit /etc/buyfriend/buyfriend.toml to your liking. It is required to change the secret key, server name, admin email and SMTP details. You can generate the secret key like this:

python -c 'import secrets; print(secrets.token_hex())'

Initialize database and create your first user account.

export BUYFRIEND_CONFIG=/etc/buyfriend/buyfriend.toml
doas -u buyfriend flask --app buyfriend init-db
doas -u buyfriend flask --app buyfriend create-user user@localhost "User Name"

Start buyfriend and NGINX and make them start on boot.

doas rc-service buyfriend start
doas rc-service nginx reload
doas rc-update add buyfriend
doas rc-update add nginx

#Contributing

Send patches to the mailing list, report bugs on the issue tracker.

#License

AGPLv3, see LICENSE.

Copyright (C) 2023 Krystian ChachuĊ‚a