Skip to content
master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Smithereen

Federated, ActivityPub-compatible social network with friends, walls, and groups.

If you have any questions or feedback, there's a Telegram chat you can join.

Building/installation

Running directly on your server

  1. Install and configure MySQL
  2. Install maven and JDK >=15 if you don't have it already
  3. Build the jar by running mvn package and place the one with dependencies at /opt/smithereen/smithereen.jar
  4. Set up the image processing native library (libvips): run java LibVipsDownloader.java to automatically download a prebuilt one from here. If you already have libvips installed on your system, you may skip this step, but be aware that not all libvips builds include all the features Smithereen needs.
  5. Install and configure imgproxy
  6. Fill in the config file, see a commented example here
  7. Create a new MySQL database and initialize it with the schema using a command (mysql -p smithereen < schema.sql) or any GUI like phpMyAdmin
  8. Configure and start the daemon: assuming your distribution uses systemd, copy the service file to /etc/systemd/system, then run systemctl daemon-reload and service smithereen start
  9. Run java -jar /opt/smithereen/smithereen.jar /etc/smithereen/config.properties init_admin to create the first account
  10. Log into that account from your web browser, then configure the rest of the server settings from its UI

Using Docker

Copy Docker-specific config example to the project root directory as config.properties and edit it to set your domain. Also edit docker-compose.yml to add your imgproxy secrets. You can then use docker-compose to run Smithereen, MySQL, and imgproxy. You still need to configure your web server to reverse proxy the port 4567. Create the first account by running docker exec -it smithereen_web_1 bash -c ./smithereen-init-admin.

About

Federated, ActivityPub-compatible social network server with friends, walls, and groups.

Topics

Resources

License

Packages

No packages published