selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Socialhome logo

Self-host Socialhome

v0.9.3

Decentralized personal profile for the fediverse

BetaOpen SourceOther
Updated8 hours ago
LanguagePython
Setup difficultyAdvanced
Stars
379
CPU
1 vCPU
RAM
650mb base + 500mb per vCPU for Dramatiq + 320mb per Daphne worker
Port
23564 (Daphne HTTP/WebSocket backend)
Requires
PostgreSQL, Redis
Docker
https://codeberg.org/socialhome/-/packages/container/socialhome
Socialhome profile view showing federated content

What is Socialhome?

Socialhome is a decentralized personal profile with social networking features. Users write posts using Markdown and optionally HTML/JS/CSS (for trusted users). Content can be pinned to profiles and federates to contacts across the federated social web via ActivityPub and Diaspora protocols. The project consists of a Django backend and a separate frontend. It runs via Docker with PostgreSQL and Redis as required dependencies. The backend listens on port 23564 and uses Circus to manage Daphne (HTTP/WebSocket) and Dramatiq (background jobs). Instances can join the public relay system via The-Federation.info for wider content discovery.

Should you self-host Socialhome?

Socialhome scores 49/100 on selfhost.directory (how scoring works) and ranks #48 of 69 in Social Networks & Forums. It has 379 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Other-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Discourse (83/100, 48 023 stars). It scores higher overall, so compare the two before you pick. See Socialhome vs Discourse side by side.

Features

  • ActivityPub Federation
  • Backup and Restore
  • Diaspora federation
  • Django Admin interface
  • Matrix Protocol SupportNot a full homeserver; different approach than ActivityPub/Diaspora
  • Profile pinning
  • Public relay system
  • Rich content creationHTML/JS/CSS only for trusted users

Socialhome README

How to configure Socialhome

  • DAPHNE_WORKER_NUM1Number of Daphne processes

    Number of Daphne processes

  • DATABASE_URLpostgres:///socialhomePostgreSQL connection URI

    PostgreSQL connection URI

  • DJANGO_ACCOUNT_ALLOW_REGISTRATIONTrueAllow user registration

    Allow user registration

    values: True/False

  • DJANGO_ALLOWED_HOSTS*Allowed host headers

    Allowed host headers

  • DJANGO_SECRET_KEYRandom secret key for sessions

    Random secret key for sessions

  • DJANGO_SECURE_SSL_REDIRECTFalseRedirect all requests to HTTPS

    Redirect all requests to HTTPS

    values: True/False

  • DRAMATIQ_NPROCSnumber of vcpusNumber of Dramatiq processes

    Number of Dramatiq processes

  • DRAMATIQ_NTHREADS8Threads per Dramatiq process

    Threads per Dramatiq process

  • REDIS_DB0Redis database number

    Redis database number

  • REDIS_HOSTRedis hostname

    Redis hostname

  • REDIS_PASSWORDRedis password

    Redis password

  • REDIS_PORTRedis port

    Redis port

  • SOCIALHOME_DOMAIN127.0.0.1:8000Socialhome domain

    Socialhome domain

  • SOCIALHOME_HTTPSFalseWhether HTTPS is used

    Whether HTTPS is used

    values: True/False

  • SOCIALHOME_SILKYFalseEnable Silk profiling

    Enable Silk profiling

    values: True/False

Socialhome releases & version history

FAQ

I accidentally shared someone's content and it's stuck on my profile stream!

This is a known caching issue. Ask your instance admin to clear the profile cache using a Redis CLI command.

How do I report a security issue?

Report security issues privately via email to mail@jasonrobinson.me, not in the public issue tracker.

If I run an instance, will it automatically connect to the network?

No. Federation works through social relationships (following users on other servers) and the public relay system. You must follow remote users or register with The-Federation.info relay to receive content.

More in Fediverse

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…