138 lines
5.3 KiB
Markdown
138 lines
5.3 KiB
Markdown
|
|
|
|
# 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...
|
|
- Multiuser
|
|
- Mastodon API support, so Mastodon-compatible apps can be used
|
|
- Simple but effective web interface
|
|
- 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.
|
|
|
|
## Building and installation
|
|
|
|
This program is written in highly portable C. It uses the `__attribute__((__cleanup__))` GNU extension, that is supported at least by the `gcc`, `clang` and `tcc` C compilers. The only external dependencies are `openssl` and `curl`.
|
|
|
|
On Debian/Ubuntu, you can satisfy these requirements by running
|
|
|
|
```sh
|
|
apt install libssl-dev libcurl4-openssl-dev
|
|
```
|
|
|
|
On OpenBSD you just need to install `curl`:
|
|
|
|
```sh
|
|
pkg_add curl
|
|
```
|
|
|
|
On FreeBSD, to install `curl` just type:
|
|
|
|
```sh
|
|
pkg install curl
|
|
```
|
|
|
|
On NetBSD, to install `curl` just type:
|
|
|
|
```sh
|
|
pkgin install curl
|
|
```
|
|
|
|
The source code is available [here](https://comam.es/what-is-snac).
|
|
|
|
Run `make` and then `make install` as root.
|
|
|
|
If you're compiling on NetBSD, you should use the specific provided Makefile and run `make -f Makefile.NetBSD` and then `make -f Makefile.NetBSD install` as root.
|
|
|
|
From version 2.27, `snac` includes support for the Mastodon API; if you are not interested on it, you can compile it out by running
|
|
|
|
```sh
|
|
make CFLAGS=-DNO_MASTODON_API
|
|
```
|
|
|
|
If your compilation process complains about undefined references to `shm_open()` and `shm_unlink()` (it happens, for example, on Ubuntu 20.04.6 LTS), run it as:
|
|
|
|
```sh
|
|
make LDFLAGS=-lrt
|
|
```
|
|
|
|
If it still gives compilation errors (because your system does not implement the shared memory functions), you can fix it with
|
|
|
|
```sh
|
|
make CFLAGS=-DWITHOUT_SHM
|
|
```
|
|
|
|
From version 2.68, Linux Landlock sandboxing is included (not supported on Linux kernels older than 5.13.0). It's still a bit experimental, so you must compile it in explicitly with
|
|
|
|
```sh
|
|
make CFLAGS=-DWITH_LINUX_SANDBOX
|
|
```
|
|
|
|
From version 2.73, the language of the web UI can be configured; the `po/` source subdirectory includes a set of translation files, one per language. After initializing your instance, copy whatever language file you want to use to the `lang/` subdirectory of the base directory.
|
|
|
|
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:
|
|
|
|
```sh
|
|
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`)
|
|
|
|
## Links of Interest
|
|
|
|
- [Online snac manuals (user, administrator and data formats)](https://comam.es/snac-doc/).
|
|
- [How to install snac on OpenBSD without relayd (by @antics@mastodon.nu)](https://chai.guru/pub/openbsd/snac.html).
|
|
- [Setting up Snac in OpenBSD (by Yonle)](https://wiki.ircnow.org/index.php?n=Openbsd.Snac).
|
|
- [How to run your own social network with snac (by Giacomo Tesio)](https://encrypted.tesio.it/2024/12/18/how-to-run-your-own-social-network.html). Includes information on how to run snac as a CGI.
|
|
- [Improving snac Performance with Nginx Proxy Cache (by Stefano Marinelli)](https://it-notes.dragas.net/2025/01/29/improving-snac-performance-with-nginx-proxy-cache/).
|
|
- [Caching Snac Proxied Media With Nginx (by Stefano Marinelli)](https://it-notes.dragas.net/2025/02/08/caching-snac-proxied-media-with-nginx/).
|
|
- [My snac config (activitypub instance) with Caddy (by ffuentes)](https://ffuentes.sdf.org/communication/2025/08/23/my-snac-config-activitypub-instance-with-caddy.html).
|
|
- [A bit of lore about Susie, snac's default avatar](https://comam.es/snac/grunfink/p/1754553922.333170).
|
|
|
|
## Incredibly awesome CSS themes for snac
|
|
|
|
- [A compilation of themes for snac (by Ворон)](https://codeberg.org/voron/snac-style).
|
|
- [A cool, elegant theme (by Haijo7)](https://codeberg.org/Haijo7/snac-custom-css).
|
|
- [A terminal-like theme (by Tetra)](https://codeberg.org/ERROR404NULLNOTFOUND/snac-terminal-theme).
|
|
|
|
## License
|
|
|
|
See the LICENSE file for details.
|
|
|
|
## Contributing
|
|
|
|
See the CONTRIBUTING.md file for details.
|
|
|
|
## Author
|
|
|
|
grunfink [@grunfink@comam.es](https://comam.es/snac/grunfink) with the help of others.
|
|
|
|
Buy grunfink a coffee: https://ko-fi.com/grunfink/
|
|
|
|
Contribute via LiberaPay: https://liberapay.com/grunfink/
|