Habitat

Habitat is a free and open source, self-hosted platform for communities to discover and discuss their local area.

Locals can create posts linked to a specific location on a map, making it easy for others to find and join the conversation about their local area.

Getting Started

Fork this repository to create your own instance of Habitat. To adhere to the AGPL license, your fork must be a public repository, so be careful not to ever commit any secrets.

Linux Server Hosting

The packages and setup required for hosting Habitat on a Linux server are in the Ansible playbook.

To run the ansible playbook:

1. Navigate to the Ansible directory
2. Copy vars.yaml.template to vars.yaml and amend its contents accordingly
3. Run ansible-playbook -i "domain-or-ip-address.example.com," -u example-user playbook.yaml --private-key=~/.ssh/example-key

Local Development

1. Navigate to the Docker/dev directory and copy the .env.dist file to create a new file called .env
2. Run docker-compose up

Run any application, symfony and composer commands from within the habitat-apache-php container:

docker exec -it habitat-apache-php bash

Habitat can be loaded in the web browser from localhost.

Further Information

• Could We Build a Decentralised Social Platform Rooted in Place?
• I'm Building Habitat