Update README

This commit is contained in:
Mia Herkt 2020-12-29 12:27:21 +01:00
parent b7c12902da
commit b5ce94edeb
Signed by untrusted user: mia
GPG key ID: 72E154B8622EC191

View file

@ -4,6 +4,12 @@ The Null Pointer
This is a no-bullshit file hosting and URL shortening service that also runs This is a no-bullshit file hosting and URL shortening service that also runs
`0x0.st <https://0x0.st>`_. Use with uWSGI. `0x0.st <https://0x0.st>`_. Use with uWSGI.
Configuration
-------------
To change settings, modify ``instance/config.py``. For more information on
instance configuration, see `the Flask documentation <https://flask.palletsprojects.com/en/2.0.x/config/#instance-folders>`_.
If you are running nginx, you should use the ``X-Accel-Redirect`` header. If you are running nginx, you should use the ``X-Accel-Redirect`` header.
To make it work, include this in your nginx configs ``server`` block:: To make it work, include this in your nginx configs ``server`` block::
@ -11,8 +17,7 @@ To make it work, include this in your nginx configs ``server`` block::
internal; internal;
} }
where ``/up`` is whatever youve configured as ``FHOST_STORAGE_PATH`` where ``/up`` is whatever youve configured as ``FHOST_STORAGE_PATH``.
in ``fhost.py``.
For all other servers, set ``FHOST_USE_X_ACCEL_REDIRECT`` to ``False`` and For all other servers, set ``FHOST_USE_X_ACCEL_REDIRECT`` to ``False`` and
``USE_X_SENDFILE`` to ``True``, assuming your server supports this. ``USE_X_SENDFILE`` to ``True``, assuming your server supports this.
@ -22,7 +27,7 @@ should be avoided at all costs.
To make files expire, simply create a cronjob that runs ``cleanup.py`` every To make files expire, simply create a cronjob that runs ``cleanup.py`` every
now and then. now and then.
Before running the service for the first time, run ``./fhost.py db upgrade``. Before running the service for the first time, run ``FLASK_APP=fhost flask db upgrade``.
NSFW Detection NSFW Detection
@ -34,32 +39,3 @@ the following:
* Caffe Python module (built for Python 3) * Caffe Python module (built for Python 3)
* ``ffmpegthumbnailer`` executable in ``$PATH`` * ``ffmpegthumbnailer`` executable in ``$PATH``
FAQ
---
Q:
Will you ever add a web interface with HTML forms?
A:
No. This would without a doubt make it very popular and quickly exceed
my hosting budget unless I started crippling it.
Q:
What about file management? Will I be able to register an account at some
point?
A:
No.
Q:
Why are you storing IP addresses with each uploaded file?
A:
This is done to make dealing with legal claims and accidental uploads
easier, e.g. when a user requests removal of all text files uploaded from
a certain address within a given time frame (it happens).
Q:
Do you accept donations?
A:
Only if you insist. Ive spent very little time and effort on this service
and I dont feel like I should be taking money for it.