Getting started¶
Install Microbe¶
You need to have Python installed on your server to use Microbe. The install script will download for you all the dependencies.
With pip¶
If you already have pip
installed on your server you can use it to install Microbe
$ pip install microbe
It will download Microbe from Pypi
Without pip¶
You can install pip
easily using your package manager or install Microbe manually following these steps :
- Get the last archive of Microbe
- Extract it
- Change path to extracted archive
- Run
python setup.py install
Note
Keep in mind that OS will otfen require you to prefix the above commands with sudo
in order to install the app system-wide.
It is recommended to create a virtual environment for Microbe via virtualenv
Upgrade Microbe¶
Warning
Upgrading Microbe will delete all the files contained in the application folder including your contents and the config file saved.
To preserve your contents, Microbe comes with two commands : save
and restore
.
- Save your contents in a Zip file using the
save
command - Upgrade Microbe with or without
pip
- Restore your contents using the
restore
command
With pip¶
$ microbe save -o mymicrobe.zip
$ pip install --upgrade microbe
$ microbe restore mymicrobe.zip
Without pip¶
$ microbe save -o mymicrobe.zip
$ cd /path/to/microbe/folder/
$ python setup.py develop -u
$ cd -
$ wget https://github.com/j0ack/microbe/archive/master.zip
$ unzip master.zip
$ cd master
$ python setup.py install
$ cd ..
$ microbe restore mymicrobe.zip