fabsetup 0.9.0

fabric setup scripts and fabric utils library

Fabric tasks in order to set up and maintain configurations, software installations and other things on a local or remote linux system (most functionality for Debian/Ubuntu).

“dotfiles on steroids”

Usage

fabsetup is a `fabric <http://www.fabfile.org/>`__ script.

# task infos

## list all tasks: '-l'
fabsetup -l

## show details: '-d'
fabsetup -d new_addon


# run tasks

fabsetup setup.regex_repl

## on your local host:
fabsetup setup.pencil3 -H localhost

## remote host:
fabsetup up -H example.com

`Setup-Howtos <./howtos>`__:

• Customize fabsetup: Initialize git repository ``fabsetup_custom` <./howtos/fabsetup-custom.md>`__

• Set up an environment without sudo access

• Webserver Certificates with Letsencrypt

• Host an Owncloud Service

• Host an own F-Droid Repository (Android App Repository)

• Host a Selfoss Service (RSS Reader Web Application)

• Install latest Node.js via nvm

• Create or update a reveal.js presentation

• `How to create and write a fabsetup-addon <./howtos/fabsetup-addon.md>`__

Known fabsetup-addons

• fabsetup-theno-letsencrypt

• fabsetup-theno-powerline-shell

• fabsetup-theno-termdown

Please contribute: Create your own fabsetup-addon and make a pull request which adds your fabsetup-addon to the known_pip_addons in fabsetup/addons.py and to this README.md.

Installation

As a pypi package with command pip2 (recommended way):

pip2 install fabsetup

# install addon, eg. fabsetup-theno-termdown
pip2 install fabsetup-theno-termdown

Raspberry Pi

On a fresh raspbian (Debian) you will need at least the following packages before installing fabsetup with pip:

sudo apt install -y git python python-pip libffi-dev libssl-dev tree curl && sudo pip install fabsetup

The whole installation will take about 15 minutes on a Raspi 3 with raspbian stretch, so you can make yourself a tea. Note: You do not need to type pip2 as pip defaults to the python2-variant of pip. If you run $ pip install fabsetup as normal usr (without sudo) pip will install with --user setting by default so fabsetup is located under ~/.local/bin. In this case you need to add ~/.local/bin to $PATH which is located in /etc/profile.

Update:

pip2 install --upgrade fabsetup

# update addon (also updates fabsetup)
pip2 install --upgrade fabsetup-theno-termdown

Install without superuser privileges:

pip2 install --user fabsetup

When running with --user pip installs the command fabsetup at ~/.local/bin. Assure that ~/.local/bin is set in your $PATH environment variable.

Uninstall:

pip2 uninstall --yes fabsetup
pip2 uninstall --yes fabsetup-addon-theno

You also can clone the github repository instead of using pip2 install:

# install requirements
sudo apt-get install  git  fabric
pip2 install --user utlz

git clone  https://github.com/theno/fabsetup.git  ~/.fabsetup

# from ~/.fabsetup dir use `fab` instead of `fabsetup`
cd ~/.fabsetup
fab -l

Development

Devel commands:

# save changes
git commit -am 'I describe my changes'

# upload to github
git push origin master

# update version number in fabsetup/_version.py

# create and publish package at pypi
fab -f fabfile-dev.py  pypi

# clean up
fab -f fabfile-dev.py  clean