暫無描述

default 631f16aea8 Updated dependencies. 2 年之前
doc eb22dc5f01 Updated documentation. 2 年之前
examples 89f6924ae2 Improve Docker image generation 2 年之前
.gitignore 0cdd193be9 [.gitignore] new file. 2 年之前
Dockerfile 89f6924ae2 Improve Docker image generation 2 年之前
LICENSE 06c838b523 Updated LICENSE. 2 年之前
Makefile 631f16aea8 Updated dependencies. 2 年之前
README.md 4afa513dce Add docker-compose support, so a working development server with HTTPS can be started with: 2 年之前
RELEASE_NOTES.md 9525be7495 Updated RELEASE_NOTES. 2 年之前
TODO.md 7b516b9b38 Updated TODO. 2 年之前
activitypub.c 292d7c3e95 Fixed log level for 'serving actor'. 2 年之前
data.c 47e6e47323 The purge ttl for stray global objects have been shortened. 2 年之前
docker-compose.yaml 4afa513dce Add docker-compose support, so a working development server with HTTPS can be started with: 2 年之前
format.c 645e7ec43e Some code reordering to placate scan-build's wrath. 2 年之前
html.c 845df51686 Don't generate empty children popups. 2 年之前
http.c 54d1013ea9 More work in check_signature() error archiving. 2 年之前
httpd.c a67a82d545 In server_get_handler(), body must be a dynamic string. 2 年之前
main.c 25acaf178c Replaced all calls to post() with enqueue_message(). 2 年之前
snac.c 645e7ec43e Some code reordering to placate scan-build's wrath. 2 年之前
snac.h 47e6e47323 The purge ttl for stray global objects have been shortened. 2 年之前
upgrade.c 67a81a7bf9 Upgrade timeline/ to private/. 2 年之前
utils.c 48ebc54b6e New command line option 'resetpwd'. 2 年之前
webfinger.c 6e0b5c9d20 Fixed typo in webfinger_request(). 2 年之前
xs.h aa82e14bc7 Backport from xs. 2 年之前
xs_curl.h b564d8bcb7 More curl timeout tweaks. 2 年之前
xs_encdec.h fa870ab358 Backport from xs. 2 年之前
xs_glob.h f2528c6c52 Backport from xs. 2 年之前
xs_httpd.h 75d0b1a932 Fix 500 errors in (OpenBSD) relayd. 2 年之前
xs_io.h 1b73c542a9 Backport from xs. 2 年之前
xs_json.h fa870ab358 Backport from xs. 2 年之前
xs_mime.h 0f4779e2a0 Backport from xs. 2 年之前
xs_openssl.h fa870ab358 Backport from xs. 2 年之前
xs_regex.h f2528c6c52 Backport from xs. 2 年之前
xs_set.h f209c3205d Use xs_set in recipient_list() and inbox_list(). 2 年之前
xs_socket.h 0f4779e2a0 Backport from xs. 2 年之前
xs_time.h ae06064e4d New command-line option purge. 2 年之前
xs_version.h 97e040e048 Backport from xs. 2 年之前

README.md

snac

A simple, minimalistic ActivityPub instance

Features

  • Lightweight, minimal dependencies
  • Extensive support of ActivityPub operations, e.g. write public notes, follow users, be followed, reply to the notes of others, admire wonderful content (like or boost), write private messages...
  • Simple but effective web interface
  • Multiuser
  • Easily-accessed MUTE button to silence morons
  • Tested interoperability with related software
  • No database needed
  • Totally JavaScript-free
  • No cookies either
  • Not much bullshit

About

This program runs as a daemon (proxied by a TLS-enabled real httpd server) and provides the basic services for a Fediverse / ActivityPub instance (sharing messages and stuff from/to other systems like Mastodon, Pleroma, Friendica, etc.).

This is not the manual; man pages snac(1) (user manual), snac(5) (formats) and snac(8) (administrator manual) are what you are looking for.

snac stands for Social Networks Are Crap.

Installation

This 2.x release is written in C (unlike the 1.x prototype, which was written in Python). The only external dependencies are openssl and curl.

On Debian/Ubuntu, you can satisfy these requirements by running

    apt install libssl-dev libcurl4-openssl-dev

On OpenBSD you also need to install curl:

    pkg_add curl

Run make and then make install as root.

See the administrator manual on how to proceed from here.

Testing via Docker

A docker-compose file is provided for development and testing. To start snac with an nginx HTTPS frontend, run:

docker-compose build && docker-compose up

This will:

  • Start snac, storing data in data/
  • Configure snac to listen on port 8001 with a server name of localhost (see examples/docker-entrypoint.sh)
  • Create a new user testuser and print the user's generated password on the console (see examples/docker-entrypoint.sh)
  • Start nginx to handle HTTPS, using the certificate pair from nginx-alpine-ssl/nginx-selfsigned.* (see examples/nginx-alpine-ssl/entrypoint.sh)

License

See the LICENSE file for details.

Author

grunfink @grunfink@comam.es