semvec/pypi-packages huggingface dataset:
weave-minimal-uberspace 0.9.1
A fastcgi wrapper for weave-minimal (for uberspace).
License: Apache License 2.0

weave-minimal-uberspace
=======================

I am a great fan of Firefox. I love its sync feature. But the sync service
provided by Mozilla sucks. Sorry for being rude.

Luckily, you can setup your own sync server. Either as described in the
`official guide <https://docs.services.mozilla.com/howtos/run-sync.html>`_ or
by using the awesome `weave-minimal
<https://github.com/posativ/weave-minimal>`_ sync server. I prefer
`weave-minimal <https://github.com/posativ/weave-minimal>`_, cause it is easy
to setup, has just a view dependencies and it works like a charm.

I am also a fan of `uberspace <https://uberspace.de/>`_, a great hosting
service located in Germany. They offer two options to host your own web
applications/services - fastcgi or as daemon process listening to a port. While
it is fine to run `weave-minimal <https://github.com/posativ/weave-minimal>`_
as a service, I prefer the fastcgi solution. It uses less resources, no need to
reserve a port and easier to maintain.

`uberspace <https://uberspace.de/>`_ + `weave-minimal
<https://github.com/posativ/weave-minimal>`_ + this project = ♥︎

Installation
------------

1. **Install the code.**

   .. code:: bash

       $ pip-2.7 install weave-minimal-uberspace
       $ cp ~/bin/weave-minimal.fcgi ~/fcgi-bin/

2. **Add a rewrite rule for a nice and clean url.**

   Just add the following rewrite rule to the ``.htaccess`` file in the
   ``~/html/`` directory.

   .. code:: apache

       RewriteEngine on
       RewriteRule ^weave/(.*)$ /fcgi-bin/weave-minimal.fcgi/$1 [QSA,L]

Afterwards your own firefox sync server is accessible under the following
url(s):

- http(s)://<uberspace name>.<uberspace host>.uberspace.de/weave/
- http(s)://<any domain you bound to your uberspace/weave/

The firefox sync server accepts new registrations by default and stores the
sync data in the directory ``~/.weave/``.

Configuration
-------------

You can only configure wether you want to allow new reagistrations or not. To
disable new registrations for your server, just create a file named
``~/.weave/disable_registration`` and you are done. If you remove the file, new
registrations are allowed again.

Patches welcome: https://github.com/oa/weave-minimal-uberspace