Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eraclitux/ansible-diaspora
[UNMAINTAINED] Ansible role to install and configure Diaspora
https://github.com/eraclitux/ansible-diaspora
Last synced: about 8 hours ago
JSON representation
[UNMAINTAINED] Ansible role to install and configure Diaspora
- Host: GitHub
- URL: https://github.com/eraclitux/ansible-diaspora
- Owner: eraclitux
- License: mit
- Created: 2014-11-29T15:16:52.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2015-12-31T10:13:33.000Z (almost 9 years ago)
- Last Synced: 2023-09-10T07:21:23.134Z (about 1 year ago)
- Homepage:
- Size: 20.5 KB
- Stars: 3
- Watchers: 4
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Ansible Diaspora
----------------
Ansible role to install and configure a Diaspora pod on a single machine.
This role automates [official installation instructions](https://wiki.diasporafoundation.org/Installation/Ubuntu/Precise).
Can be used to modify and deploy configuration files in `/templates`. When modified they trigger restart of appropriate services.
Not suitable for Diaspora's upgrades.
Example Playbook
----------------
First of all put certificates files (.crt ank .key) in role's `files` dir **or your production installation wont't work!**
Than create a playbook (e.g. `diaspora.yml`) with these lines:
```
- hosts: diaspora-pods
roles:
- diaspora
```
Variable `diaspora_url` must be specified per host. Easiest place to do so is in the inventory file (usually `/etc/ansible/hosts`):
```
[diaspora-pods]
targetmachine1.net diaspora_url=pod.ofmine.tld
targetmachine2.net diaspora_url=anotherpod.ofmine.tld
```
Now installing Diaspora is as easy as running (better in `screen` as it takes time):
```
$ ansible-playbook diaspora.yml -u -i
```
`` is the user which should run the installation (e.g. `root`), `` specifies the inventory host file.
After installation is finished login to remote server and issue:
```
# sudo -i -u diaspora
$ ./diaspora/script/server
```
Role Variables
--------------
- diaspora_version
Git tag of version to install. Default master.
- diaspora_url
This should be the URL you want to use to access the pod. Do not prepone `http://` nor postpone `/` to uri.
DO NOT CHANGE THIS AFTER INITIAL SETUP! *If you do change the URL, you will have to start again as the URL will be hardcoded into the database.*
SSL cerificate
--------------
Get for free a certificate from startssl.com and follow [these instructions](http://www.startssl.com/?app-42) to create required files and put them into `files` folder. They *must* be named like pod's public url setted in `diaspora_url` for example `pod.ofmine.crt` and `pod.ofmine.tld.key`. This is required for a production installation.
Diaspora configuration
----------------------
To customize pod's settings you can edit:
- `templates/database.yml.j2`
- `templates/diaspora.yml.j2`
- `templates/schedule.rb.j2`
Help & issues
-------------
Please [report bugs or feature requests](https://github.com/eraclitux/ansible-diaspora/issues) to improve this role.