devilbox/docs/getting-started/start-the-devilbox.rst

74 lines
2.3 KiB
ReStructuredText
Raw Normal View History

2018-03-10 21:29:15 +00:00
******************
Start the Devilbox
******************
2018-03-11 11:33:54 +00:00
Congratulations, when you have reached this page everything has been set up and you can now get your
hands dirty.
.. note::
Starting and stopping containers is done via ``docker-compose``. If you have never worked with
it before, have a look at their documentation for an
`overview <https://docs.docker.com/compose/reference/overview/>`_,
`up <https://docs.docker.com/compose/reference/up/>`_ and
`stop <https://docs.docker.com/compose/reference/stop/>`_ commands.
Start all container
===================
If you want all provided services to be available (as defined in ``docker-compose.yml``),
just start them all via:
.. code-block:: bash
docker-compose up
* If you want to gracefully stop all container, hit ``Ctrl + c``
* If you want to kill all container, hit ``Ctrl + c`` twice
Start some container
====================
If you don't require all services to be up and running and let's say just ``PHP``, ``HTTPD`` and
``MYSQL``, enter the following command:
.. code-block:: bash
docker-compose up httpd php mysql
* If you want to gracefully stop all started container, hit ``Ctrl + c``
* If you want to kill all started container, hit ``Ctrl + c`` twice
.. seealso::
:ref:`available_container`
Have a look at this page to get an overview about all available container and by what name
they have to be specified.
Open Devilbox intranet
======================
Once ``docker-compose up`` has finished and all or the selected container are up and running,
you can visit the Devilbox intranet with your favorite Web browser at http://localhost or
http://127.0.0.1.
The Intranet start page will also show you all running and failed containers:
.. image:: /_static/img/devilbox-dash-full.png
.. image:: /_static/img/devilbox-dash-selective.png
.. warning::
:ref:`docker_toolbox`
When you are using ``Docker Toolbox`` the Devilbox Web server port will not be available on
your host computer. You have to forward the virtual machines port to your host computer.
Read more about it on this guide.
Checklist
=========
1. Docker container are started successfully with ``docker-compose up``
2. Intranet is reachable via ``http://localhost`` or ``http://127.0.0.1``