Deployment of packaged solutions

Did you say "Open Source"?

CiteLibre's digital services are 100% open source, which means that the code used to implement them is entirely downloadable and allows you to deploy them identically, or make modifications to adapt them to your own needs (graphic charter, database or other servers hosted in-house, etc.). 

However, these packages are also shared with you by the City of Paris and its community of contributors so that they can be easily deployed without having to modify the code, as part of a test or demo.

While waiting for the demo sites for each service to open soon, you can launch these services on your computer, in your container environment. You will therefore need software that allows you to launch containerised environments. We have used Docker Desktop for the illustrations in this guide.

For each solution in the CiteLibre suite, you will find a download link that will take you to the server where you will find the docker-compose.yml and external.env files at the root of the directory. Download them and store them in the location of your choice on your computer (a dedicated directory is preferable).

Please refer to the documentation specific to the external.env file (accessible here for the "rendez-vous" application, for example). This file allows you to configure your time zone (if different from Paris, France), among other things.

 

 

 

Launching the application without data persistence (demo mode)

By default, the application is launched in fully containerised mode. This means that each time the application is rebuilt (following an update, for example), all the services will be reset to their default values. You therefore run the risk of losing any data you have modified.

Open a command prompt, navigate to the location where the previously downloaded file is stored and simply run the command "docker-compose up".

 

 

You will then download all the server images needed to launch the solution in your container environment.

For each solution, the readme file contains information about the architecture, as well as the URLs and identifiers you need to use to connect to the administration interface.

If you are still unable to launch the solution, please contact us.

 

Launch with data persistence

You can find documentation on data persistence in the readme-dev on github.