dpaste/docs/management_commands.rst

.. _management_commands:

===================
Management Commands
===================

.. _purge_expired_snippets:

Purge expired snippets
======================

dpaste ships with a management command ``cleanup_snippets`` that removes
expired snippets. To run it locally do:

.. code-block:: bash

    $ pipenv run ./managepy cleanup_snippets

Options
-------

--dry-run   Does not actually delete the snippets.
            This is useful for local testing.

Setup a Crontab
---------------

It's important that you setup a crontab or similar to remove expired snippets
as soon as they reach their expiration date. A crontab line might look like:

.. code-block:: bash

    */5 * * * * /srv/dpaste.de/pipenv run manage.py cleanup_snippets > /dev/null


.. note:: If you use the *database* session backend, you may also need to setup
    a crontab that removes the expired entries from the session database.

    See the related `Django Documentation`_ for details.

.. _Django Documentation: https://docs.djangoproject.com/en/2.0/ref/django-admin/#django-admin-clearsessions