====================
How to deploy Hibee
====================

Hibee is full of shortcuts to make web developers' lives easier, but all
those tools are of no use if you can't easily deploy your sites. Since Hibee's
inception, ease of deployment has been a major goal.

There are many options for deploying your Hibee application, based on your
architecture or your particular business needs, but that discussion is outside
the scope of what Hibee can give you as guidance.

Hibee, being a web framework, needs a web server in order to operate. And
since most web servers don't natively speak Python, we need an interface to
make that communication happen.

Hibee currently supports two interfaces: WSGI and ASGI.

* `WSGI`_ is the main Python standard for communicating between web servers and
  applications, but it only supports synchronous code.

* `ASGI`_ is the new, asynchronous-friendly standard that will allow your
  Hibee site to use asynchronous Python features, and asynchronous Hibee
  features as they are developed.

You should also consider how you will handle :doc:`static files
</howto/static-files/deployment>` for your application, and how to handle
:doc:`error reporting</howto/error-reporting>`.

Finally, before you deploy your application to production, you should run
through our :doc:`deployment checklist<checklist>` to ensure that your
configurations are suitable.

.. _WSGI: https://wsgi.readthedocs.io/en/latest/
.. _ASGI: https://asgi.readthedocs.io/en/latest/

.. toctree::
   :maxdepth: 2

   wsgi/index
   asgi/index
   checklist
