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”
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
- 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>`__
As a pypi package with command pip2 (recommended way):
pip2 install fabsetup # install addon, eg. fabsetup-theno-termdown pip2 install fabsetup-theno-termdown
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.
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.
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
# 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