0x0 is a no-bullshit file hosting and URL shortening service that also runs 0x0.st. Use with uWSGI.

## Configuration

To configure 0x0, copy `instance/config.example.py` to `instance/config.py`, then edit it. Resonable defaults are set, but there's a couple options you'll need to change before running 0x0 for the first time. Before running the service for the first time and every time you update it from this git repository, run `FLASK_APP=fhost flask db upgrade`.

If you are running nginx, you should use the `X-Accel-Redirect` header. For all other servers, set `FHOST_USE_X_ACCEL_REDIRECT` to `False` and `USE_X_SENDFILE` to `True`, assuming your server supports this.

To make files expire, simply run `FLASK_APP=fhost flask prune` every now and then. You can use the provided systemd unit files for this: `0x0-prune.service` and `0x0-prune.timer`.

## Moderation UI

0x0 features a TUI program for file moderation. With it, you can view a list of uploaded files, as well as extended information on them. It allows you to take actions like removing files temporarily or permanently, as well as blocking IP addresses and associated files.

If a sufficiently recent version of python-mpv with libmpv is present and your terminal supports it, you also get graphical file previews, including video playback.

## NSFW Detection

0x0 supports classification of NSFW content via a machine learning model. This works for images and video files.

## Virus Scanning

0x0 can scan its files with ClamAV’s daemon. As this can take a long time for larger files, this does not happen immediately but instead every time you run the `vscan` command. It is recommended to configure a systemd timer or cronjob to do this periodically.

## Network Security Considerations

Keep in mind that 0x0 can fetch files from URLs. This includes your local network! You should take precautions so that this feature cannot be abused.