======================================================
PlantUML Server
======================================================

A `PlantUML server <http://plantuml.com/server>`_ generates an output image from input PlantUML source code.

* It is possible to setup your own server (`docker images available <https://hub.docker.com/r/plantuml/plantuml-server/>`_).
* Here we will use the public plantuml server http://www.plantuml.com/plantuml 

We provide our PlantUML source code as input via a URL and get back a PNG/SVG image.

Using a similar PlantUML Server, we can edit the PlantUML source code via a webbrowser.


Encoding URL for PlantUML Server for source and diagram
=========================================================

Example Diagram Source
------------------------
We will use our :ref:`Context` diagram source as an example.

.. literalinclude:: ./plantuml/C4-PlantUML/examples/C4_ContextDiagramSample-bigbankplc-landscape.puml
    :linenos: 

Diagram Source Encoded as URL
------------------------------
The input PlantUML source code and output image can be encoded as URLs:

`Input UML source code URL <http://www.plantuml.com/plantuml/uml/TLL1R-8y4BtdLyo7AXKalhA7dbPLLGfeMoqjLGEgLbefCiw4M3XsrkEKejN-zxL3o9e25nJFl9bvR_mixiWoOwj2Hly9nMML8jpmwy7eEXbfPV73NfKkUGiGHPS6CyYjBRyE1gLaobTTSLqCoAPIB8C6Eii4ny62qD2WSh-x9kSGXLuAYKa0Z2wdmn-pnJoPprwIyUpjkGqCuoJ-FfcF7hgzg0czFSuVakdas-Hvx8AH5LOYn5koMC2KgPGuAn5ImLQ65P1f0_TY1VTChQ6KF8fU70UjkhmYgmiq07qOxR_xqBcvyCHkuUOYu7dxKy4GsXATWSqHbgvd7pR2vb3MJPciOy0urvMor057SA8icj88mkJUHLDcjbt-nKqAQNLwy3i2W4P8rxSHQfLGVNJWHzz5eVKLFjC0Eourb59lg6L7O3My2zo0K4vzmQpG2jXILzQp5kQGOn_Spg1WQuIIRGjqeQjEBmh899CFssMsyAFcJ-Sc-ZMaXcs0CyfTXyyD2YRaFpcJ__qPg1Knpn54hP59U1BSQDAPXSa7pvbQ8M1OS8gWIwlCi09TiwVzzubjnLOR961Ixg-Hkm0q2p-nirPbFzYPDKmHunxcJcXvIsbdhvhIlZ8XDE-2UsQjq-9T26BBigmJPXemaC_KQnMgjPiRytdAal5ridjWtbJk13Dt2diFqq8eGTOqkbGAL9MbDlRyb3zHz8eoUKQnofVQj6BwSEJD1I6v2Wz_3N0xoxmrlg3Q652HAst0dck0FtH8Z2gbvjgzmLpDqOGJ2nxIck1NXUILrdNUN2YnpBN2VPFnqGCxFpoaxARNgaApXUgFsvu6Ze-zSGww22xuD2gQicqotX4xd7-Osu_irS55-2B3v9tJxlyW_W80>`_ :


.. code::

    http://www.plantuml.com/plantuml/uml/TLL1R-8y4BtdLyo7AXKalhA7dbPLLGfeMoqjLGEgLbefCiw4M3XsrkEKejN-zxL3o9e25nJFl9bvR_mixiWoOwj2Hly9nMML8jpmwy7eEXbfPV73NfKkUGiGHPS6CyYjBRyE1gLaobTTSLqCoAPIB8C6Eii4ny62qD2WSh-x9kSGXLuAYKa0Z2wdmn-pnJoPprwIyUpjkGqCuoJ-FfcF7hgzg0czFSuVakdas-Hvx8AH5LOYn5koMC2KgPGuAn5ImLQ65P1f0_TY1VTChQ6KF8fU70UjkhmYgmiq07qOxR_xqBcvyCHkuUOYu7dxKy4GsXATWSqHbgvd7pR2vb3MJPciOy0urvMor057SA8icj88mkJUHLDcjbt-nKqAQNLwy3i2W4P8rxSHQfLGVNJWHzz5eVKLFjC0Eourb59lg6L7O3My2zo0K4vzmQpG2jXILzQp5kQGOn_Spg1WQuIIRGjqeQjEBmh899CFssMsyAFcJ-Sc-ZMaXcs0CyfTXyyD2YRaFpcJ__qPg1Knpn54hP59U1BSQDAPXSa7pvbQ8M1OS8gWIwlCi09TiwVzzubjnLOR961Ixg-Hkm0q2p-nirPbFzYPDKmHunxcJcXvIsbdhvhIlZ8XDE-2UsQjq-9T26BBigmJPXemaC_KQnMgjPiRytdAal5ridjWtbJk13Dt2diFqq8eGTOqkbGAL9MbDlRyb3zHz8eoUKQnofVQj6BwSEJD1I6v2Wz_3N0xoxmrlg3Q652HAst0dck0FtH8Z2gbvjgzmLpDqOGJ2nxIck1NXUILrdNUN2YnpBN2VPFnqGCxFpoaxARNgaApXUgFsvu6Ze-zSGww22xuD2gQicqotX4xd7-Osu_irS55-2B3v9tJxlyW_W80 

where this URL can be generated by

* copyNpasting the source code into http://www.plantuml.com/plantuml server uml window
* plantuml running locally

This URL contains the encoded PlantUML diagram source code.

Link to Render PNG from Diagram Source Encoded URL
---------------------------------------------------

2. `Output Png Image <http://www.plantuml.com/plantuml/uml/TLL1R-8y4BtdLyo7AXKalhA7dbPLLGfeMoqjLGEgLbefCiw4M3XsrkEKejN-zxL3o9e25nJFl9bvR_mixiWoOwj2Hly9nMML8jpmwy7eEXbfPV73NfKkUGiGHPS6CyYjBRyE1gLaobTTSLqCoAPIB8C6Eii4ny62qD2WSh-x9kSGXLuAYKa0Z2wdmn-pnJoPprwIyUpjkGqCuoJ-FfcF7hgzg0czFSuVakdas-Hvx8AH5LOYn5koMC2KgPGuAn5ImLQ65P1f0_TY1VTChQ6KF8fU70UjkhmYgmiq07qOxR_xqBcvyCHkuUOYu7dxKy4GsXATWSqHbgvd7pR2vb3MJPciOy0urvMor057SA8icj88mkJUHLDcjbt-nKqAQNLwy3i2W4P8rxSHQfLGVNJWHzz5eVKLFjC0Eourb59lg6L7O3My2zo0K4vzmQpG2jXILzQp5kQGOn_Spg1WQuIIRGjqeQjEBmh899CFssMsyAFcJ-Sc-ZMaXcs0CyfTXyyD2YRaFpcJ__qPg1Knpn54hP59U1BSQDAPXSa7pvbQ8M1OS8gWIwlCi09TiwVzzubjnLOR961Ixg-Hkm0q2p-nirPbFzYPDKmHunxcJcXvIsbdhvhIlZ8XDE-2UsQjq-9T26BBigmJPXemaC_KQnMgjPiRytdAal5ridjWtbJk13Dt2diFqq8eGTOqkbGAL9MbDlRyb3zHz8eoUKQnofVQj6BwSEJD1I6v2Wz_3N0xoxmrlg3Q652HAst0dck0FtH8Z2gbvjgzmLpDqOGJ2nxIck1NXUILrdNUN2YnpBN2VPFnqGCxFpoaxARNgaApXUgFsvu6Ze-zSGww22xuD2gQicqotX4xd7-Osu_irS55-2B3v9tJxlyW_W80>`_ :


.. code::
    
    http://www.plantuml.com/plantuml/png/TLL1R-8y4BtdLyo7AXKalhA7dbPLLGfeMoqjLGEgLbefCiw4M3XsrkEKejN-zxL3o9e25nJFl9bvR_mixiWoOwj2Hly9nMML8jpmwy7eEXbfPV73NfKkUGiGHPS6CyYjBRyE1gLaobTTSLqCoAPIB8C6Eii4ny62qD2WSh-x9kSGXLuAYKa0Z2wdmn-pnJoPprwIyUpjkGqCuoJ-FfcF7hgzg0czFSuVakdas-Hvx8AH5LOYn5koMC2KgPGuAn5ImLQ65P1f0_TY1VTChQ6KF8fU70UjkhmYgmiq07qOxR_xqBcvyCHkuUOYu7dxKy4GsXATWSqHbgvd7pR2vb3MJPciOy0urvMor057SA8icj88mkJUHLDcjbt-nKqAQNLwy3i2W4P8rxSHQfLGVNJWHzz5eVKLFjC0Eourb59lg6L7O3My2zo0K4vzmQpG2jXILzQp5kQGOn_Spg1WQuIIRGjqeQjEBmh899CFssMsyAFcJ-Sc-ZMaXcs0CyfTXyyD2YRaFpcJ__qPg1Knpn54hP59U1BSQDAPXSa7pvbQ8M1OS8gWIwlCi09TiwVzzubjnLOR961Ixg-Hkm0q2p-nirPbFzYPDKmHunxcJcXvIsbdhvhIlZ8XDE-2UsQjq-9T26BBigmJPXemaC_KQnMgjPiRytdAal5ridjWtbJk13Dt2diFqq8eGTOqkbGAL9MbDlRyb3zHz8eoUKQnofVQj6BwSEJD1I6v2Wz_3N0xoxmrlg3Q652HAst0dck0FtH8Z2gbvjgzmLpDqOGJ2nxIck1NXUILrdNUN2YnpBN2VPFnqGCxFpoaxARNgaApXUgFsvu6Ze-zSGww22xuD2gQicqotX4xd7-Osu_irS55-2B3v9tJxlyW_W80 

where 

http://www.plantuml.com/plantuml/**uml**/...  changes to 

http://www.plantuml.com/plantuml/**png**/...