Habitat
★ 150GNU Affero General Public License v3.0Open Source — No Paywall2 Containers — 2 containers — light hosting footprintCompose · SourceNo external DB3 active committers (12mo)
About
Habitat is a web platform for local communities. It is designed for people who want to run a community instance for a specific area, where residents can join and discuss local matters. The project...
Community Ratings
No ratings yetNew this week
Read recap →Weekly Recap — Oct 9, 2026 – Oct 16, 2026Oct 16, 2026
Features
- local community instances
- location-based discussions
- desktop and mobile web access
- decentralised deployment
Details
- Last Updated
- Oct 3, 2026
- Created
- May 12, 2024
- Install Methods
- docker-composesource
- Requirements
- PostgreSQLDocker ComposeAnsibleSymfonyComposer
- Runtime / Stack
- Docker
- Privacy & Independence
- No TelemetryNo Cloud Required
- User Model
- Multi-UserMulti-Tenant
- Deployment
Deployment: Docker Compose ✓2 Containers — light hosting footprintRuns as 2 containers
Run Habitat with Docker Compose
Compose file from the Habitat project repository.
2 services
no resource limits declared
needs persistent storage (3 volumes)
compose.prod.yaml · @ 9952051 · scanned Sep 23, 2026
---
# TODO: Put this into the Github CI
#
# NOTE: Ensure you have ran npm run build first -- otherwise, if you've ran watch the js/css won't be compressed
#
# npm run build
#
# docker system prune -a --volumes
# docker compose -f compose.yaml -f compose.prod.yaml build --pull --no-cache
#
# # Test the image only:
# docker compose -f compose.yaml -f compose.prod.yaml up
#
# docker tag carlnewton/habitat carlnewton/habitat:develop
# docker push carlnewton/habitat:develop
#
# docker tag carlnewton/habitat carlnewton/habitat:1.2.3-rc1
# docker push carlnewton/habitat:1.2.3-rc1
#
# docker tag carlnewton/habitat carlnewton/habitat:1.2.3
# docker push carlnewton/habitat:1.2.3
#
# docker tag carlnewton/habitat carlnewton/habitat:latest
# docker push carlnewton/habitat:latest
services:
habitat-app:
build:
context: .
target: frankenphp_prod
image: carlnewton/habitat
environment:
MERCURE_PUBLISHER_JWT_KEY: ${CADDY_MERCURE_JWT_SECRET}
MERCURE_SUBSCRIBER_JWT_KEY: ${CADDY_MERCURE_JWT_SECRET}
habitat-worker:
extends:
file: compose.yaml
service: habitat-worker
image: ${IMAGES_PREFIX:-}app-php-worker
build:
context: .
target: frankenphp_prod
command: ['bin/console', 'messenger:consume', '-vv', '--time-limit=600', '--limit=10', '--memory-limit=128M']
volumes:
- ./:/app
- /app/var/
- habitat_uploads:/uploads
depends_on:
habitat-app:
condition: service_healthy
This file may be out of date. Check the Habitat documentation for current setup steps.
Tags
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.
Metadata extracted from README on Jul 20, 2026
Related Software
Mastodon
50.4k
Mastodon is a free, open-source social network server based on ActivityPub for publishing posts, media, and interacting across the federated Fediverse.
Social NetworksCopyleft LicenseSocial Media+2
Fully FOSS
Discourse
48.0k
An open-source community platform for running discussion forums and real-time chat.
Social NetworksCopyleft LicenseSelf Hosting Solutions+1
Lemmy
14.6k
Lemmy is a self-hostable, decentralized link aggregator and forum for the fediverse.
Social NetworksBookmark ManagementSelf Hosting Solutions+1
5 Containers
Isso
5.3k
Isso is a lightweight commenting server written in Python and JavaScript, designed as a drop-in replacement for Disqus.
Social NetworksPermissive LicenseBlogging Platforms+2
2 Containers
Answer
15.7k
Apache Answer is a Q&A platform for teams that can be used as a community forum, help center, or knowledge management platform.
Social NetworksPermissive LicenseKnowledge Management+1
PixelFed
7.1k
Pixelfed is a photo-sharing social platform for the fediverse that helps users share casual and creative photography without algorithmic barriers.
Social NetworksCopyleft LicensePhoto Galleries+2
5 ContainersFully FOSS
Lila
18.9k
Lila is a free online chess game server focused on realtime gameplay and ease of use.
GamesWeb ServersSocial Networks+1
Misskey
11.3k
Misskey is an open-source federated social media platform.
Social NetworksSocial MediaSelf Hosting Solutions+2
2 Containers
slskd
4.1k
A modern client-server web application for using the Soulseek file-sharing network.
P2P File SharingCopyleft LicenseMedia Management+2
Misago
2.8k
Misago is a modern forum software platform for building feature-rich online communities.
Social NetworksSelf Hosting SolutionsWeb Servers+1
5 Containers
remark42
5.6k
Remark42 is a self-hosted, lightweight comment engine that can be embedded into websites and blogs.
Social NetworksPermissive LicenseComment Systems+3
Flarum
16.4k
Flarum is a simple, fast, extensible discussion platform for building online communities and forums.
Social NetworksPermissive LicenseSelf Hosting Solutions+1
