devilbox/docs/maintenance/remove-the-devilbox.rst

134 lines
3.0 KiB
ReStructuredText

.. include:: /_includes/snippets/__ANNOUNCEMENTS__.rst
.. _remove_the_devilbox:
*******************
Remove the Devilbox
*******************
If you want to completely remove the Devilbox follow this tutorial.
**Table of Contents**
.. contents:: :local:
Backups
=======
Before deleting the Devilbox git directory, ask yourself if you want to make backups of all
customizations you have done so far as well as of all data that may be present within that
directory.
Dump databases
--------------
Before shutting down the Devilbox, do a final backup of all of your databases:
.. seealso::
* :ref:`backup_and_restore_mysql`
* :ref:`backup_and_restore_pgsql`
* :ref:`backup_and_restore_mongo`
Dumps will end up in ``backups/``.
Shutdown the Devilbox
---------------------
Before attempting to backup any file system data, make sure the Devilbox is properly shutdown.
.. code-block:: bash
host> docker-compose stop
Backup configuration files
--------------------------
You should now backup the following configuration files:
* Backup your customized ``.env`` file
* Backup your customized ``.docker-compose.override.yml`` file
* Backup your customized bash configuration from ``bash/``
* Backup all custom service configurations from ``cfg/``
* Backup the Devilbox root certificate from ``ca/``
Backup data and dumps
---------------------
You should now backup the following data:
* Backup any backups created in ``backups/``
* Backup any project or Docker data from ``data/``
Remove the Devilbox
===================
If you have followed the backup routine, you can continue deleting all created components.
Remove Devilbox containers
--------------------------
Navigate to the Devilbox git directory and remove all Devilbox container:
.. code-block:: bash
host> docker-compose rm -f
Remove Devilbox network
-----------------------
1. List all existing Docker networks via
.. code-block:: bash
host> docker network ls
NETWORK ID NAME DRIVER SCOPE
0069843ff0c3 bridge bridge local
...
9c8d4a84cf2d devilbox_app_net bridge local
2. Find the NETWORK ID of the Devilbox network and delete it:
.. code-block:: bash
host> docker network rm 9c8d4a84cf2d
Remove Devilbox git directory
-----------------------------
You can simply delete the whole Devilbox git directory
Revert your system changes
==========================
AutoDNS
-------
Revert any changes you have done for Auto-DNS to work.
.. seealso:: :ref:`setup_auto_dns`
Manual DNS entries
------------------
Revert any changes you have done in ``/etc/hosts`` (or ``C:\Windows\System32\drivers\etc`` for Windows)
.. seealso::
* :ref:`howto_add_project_hosts_entry_on_mac`
* :ref:`howto_add_project_hosts_entry_on_win`
Remove Devilbox CA from your browser
------------------------------------
Remove the Devilbox CA from your browser
.. seealso::
* :ref:`setup_valid_https`