{"id":21615182,"url":"https://github.com/eea/eea.docker.daviz","last_synced_at":"2026-04-12T02:36:00.939Z","repository":{"id":137839133,"uuid":"42056682","full_name":"eea/eea.docker.daviz","owner":"eea","description":null,"archived":false,"fork":false,"pushed_at":"2017-05-02T09:16:16.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":45,"default_branch":"master","last_synced_at":"2025-03-18T16:56:47.531Z","etag":null,"topics":["data-visualization","docker-installation","plone"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-09-07T14:14:52.000Z","updated_at":"2017-05-10T19:12:04.000Z","dependencies_parsed_at":"2023-04-30T17:33:37.449Z","dependency_job_id":null,"html_url":"https://github.com/eea/eea.docker.daviz","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/eea/eea.docker.daviz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.daviz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.daviz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.daviz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.daviz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eea","download_url":"https://codeload.github.com/eea/eea.docker.daviz/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.daviz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278322146,"owners_count":25967874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-visualization","docker-installation","plone"],"created_at":"2024-11-24T22:10:47.373Z","updated_at":"2025-10-04T14:14:59.234Z","avatar_url":"https://github.com/eea.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# eea.docker.daviz\n\nThis document explains how to install and run a Plone instance (with the _EEA Daviz_ add-on installed) from a Docker container.\n\n\n### Installing Docker ###\n\nIn order to build and run a container, you first need to install Docker. The installation steps to be taken depend on the operating system of your computer, as follows:\n\n#### Linux ####\n\nThe way to install Docker varies depending on the Linux distribution on your computer. You can find specific installation instructions for your distribution here: _[Docker Installation](https://docs.docker.com/installation/ \"Docker Installation\")_.\n\n#### Windows ####\n\nBecause Docker relies on Linux-specific features, you can’t install it and run it natively in Windows. One approach is to install the _[Docker Toolbox](https://www.docker.com/toolbox \"Docker Toolbox\")_ application which sets up a specific Docker environment on your computer. \n\nLaunch a Docker Toolbox _terminal_ by double-clicking the “Docker Quickstart Terminal” icon on your Desktop. If the system displays a User Account Control prompt to allow VirtualBox to make changes to your computer, choose Yes.  \nThe terminal does several things to set up Docker Toolbox for you. When it is done, the terminal displays the **`$`** prompt where you can type bash commands; the terminal runs a special _bash_ environment instead of the standard Windows command prompt, since the bash environment is required by Docker.\n\nMore information about installing Docker and working with containers can be found here: _[Get Started with Docker for Windows](http://docs.docker.com/windows/started/ \"Get Started with Docker for Windows\")_.\n\n#### Mac OS X ####\n\nBecause Docker relies on Linux-specific features, you can’t install it and run it natively in OS X. One approach is to install the _[Docker Toolbox](https://www.docker.com/toolbox \"Docker Toolbox\")_ application which sets up a specific Docker environment on your computer.\n\nLaunch a Docker Toolbox _terminal_ by clicking the “Docker Quickstart Terminal” icon from the Launchpad. The terminal does several things to set up Docker Toolbox for you. When it is done, the terminal displays the **`$`** prompt where you can type _bash_ commands; the terminal runs a special bash environment instead of the standard Windows command prompt, since the bash environment is required by Docker.\n\nMore information about installing Docker and working with containers can be found here: _[Get Started with Docker for Mac OS X](http://docs.docker.com/mac/started/ \"Get Started with Docker for Mac OS X\")_.\n\n### Building and running the Plone-Daviz container ###\n\nThere are two ways of building and running a Docker container using the terminal:  \n- by issuing the `docker` command and manually specifying configuration parameters of the container at the terminal prompt (parameters such as the name of the container, ports to be used for accessing the container etc.);  \n- by issuing the `docker-compose` command which automatically reads the configuration parameters of the container from an existing configuration file (e.g.: the “docker-compose.yml” file).\n\nA good practice is to use the `docker-compose` command. Given the fact that, for now, the Docker Toolbox version for Windows does not support this command, the `docker` command can be used instead.\n\nFirst of all, issue the following command (without the “$”):\n\n**$** `git clone https://github.com/eea/eea.docker.daviz.git`\n\nThis will create a folder named “eea.docker.daviz” which contains the necessary files to build and run the Plone-Daviz container (e.g. “docker-compose.yml”). This folder will be your _repository directory_ from which you launch specific Docker commands. To navigate inside this folder, run this:\n\n**$** `cd eea.docker.daviz/`\n\n#### Using the **`docker-compose`** command (Linux and Mac OS X) ####\n\nUsing the terminal (for OS X, the Docker Toolbox terminal), navigate to your repository directory and issue the following command (without the “$”):\n\n**$** `docker-compose up`\n\nThis will both _create_ and _start_ the Docker container which has the Plone-Daviz instance in it. The command runs for a while and does several things in order to set up the container. When it is finished, the message “Ready to handle requests” will apear on the terminal screen, indicating that the container has been created and is currently started (meaning that it is in the “started” state). After issuing this command, you are not able to issue further commands, since the terminal prompt is not available to you. To make it available, you can press “CTRL-c”, but by doing so, you might stop the Plone-Daviz container, thus bringing it in the “stopped” state. The container will not be removed, but only stopped.  \n\nTo see the container's current status, issue the following command:\n\n**$** `docker-compose ps`\n\nA state of “Up” means that the container is started, and a state of “Exit” means that it is stopped.\n\nIn case it is stopped, to start again the Plone-Daviz container, issue this command:\n\n**$** `docker-compose start`\n\nThis command will bring the container into the “started” state; it will not build again the container (since it was already built by the `docker-compose up` command), but it will only start it. If needed, you may stop or restart the container by issuing one of the following commands:\n\n**$** `docker-compose stop`  \n**$** `docker-compose restart`\n\nYou are able to access the Plone-Daviz instance from your web browser only if the Plone-Daviz container is in the “started” state.\n\n_Note_: you are able to issue the `docker-compose up` command multiple times, but by doing so, be aware that the Plone-Daviz container will not only be started, but also be re-created. This means that any changes previously performed to the Plone-Daviz instance (via the web browser) will be _lost_.\n\n#### Using the **`docker`** command (Windows) ####\n\nUsing the Docker Toolbox terminal, while located in your repository directory, issue the following command (without the “$”):\n\n**$** `docker run -p 80:8080 --name plone_daviz_container eeacms/daviz`\n\nThe command will both _create_ and _start_ a Docker container named “plone\\_daviz\\_container” which has the Plone-Daviz instance in it. The command runs for a while and does several things in order to set up the container. When it is finished, the message “Ready to handle requests” will apear on the terminal screen, indicating that the container has been created and is currently started (meaning that it is in the “started” state). After issuing this command, you are not able to issue further commands, since the terminal prompt is not available to you. To make it available, you can press “CTRL-c”, but by doing so, you might stop the “plone\\_daviz\\_container” container, thus bringing it in the “stopped” state. The container will not be removed, but only stopped.\n\nTo see the container's current status, issue the following command and look for the container named “plone\\_daviz\\_container”:\n\n**$** `docker ps -a`\n\nA state of “Up” means that the container is started, and a state of “Exit” means that it is stopped.\n\nIn case it is stopped, to start again the Plone-Daviz container, issue this command:\n\n**$** `$ docker start plone_daviz_container`\n\nThis command will bring the container into the “started” state; it will not build again the container (since it was already built by the `docker run` command), but it will just start it. If needed, you may stop or restart the container by issuing one of the following commands:\n\n**$** `docker stop plone_daviz_container`  \n**$** `docker restart plone_daviz_container`\n\nYou are able to access the Plone-Daviz instance from your web browser only if the Plone-Daviz container is in the “started” state.\n\n### Accessing the Plone-Daviz instance from your web browser ###\n\n#### Linux ####\n\nAs long as the Plone-Daviz container is in the “started” state, you are able to access the Plone instance from the web browser. To do that, enter “localhost” or “127.0.0.1” in the address bar of the browser. Alternatively, you can type \"http://localhost:80\" or \"http://127.0.0.1:80\". After pressing Enter, the Plone start page should be displayed. Again, note that this works as long as the container is _started_.\n\n#### Windows and OS X ####\n\nIn order to access the Plone-Daviz instance using the web browser, you first need to identify the IP address of the Docker environment on your computer. Issue the following command to accomplish this:\n\n**$** `echo $DOCKER_HOST`\n\nThis should display an address which has the following format: “protocol://**ip\\_address**:port” (for example “tcp://192.168.99.100:2376”). Open a web browser and enter the IP address (only **ip\\_address**) in the address bar of the browser. Alternatively, you can type \"http://**ip\\_address**:80\". After pressing Enter, the Plone start page should be displayed on your browser. Note that this works as long as the Plone-Daviz container (named “plone\\_daviz\\_container”) is in a running state.\nNote: in Windows, if you are using the Internet Explorer browser and after entering the IP address in the address bar the Plone start page does not show, you might try using another web browser (e.g. Google Chrome).\n\n### Creating the Plone site ###\n\nOnce you have the Plone start page displayed on your browser, click the “Create a new Plone site” button. You are prompted to authenticate in order to proceed further. Type _admin_ for both User Name and Password.\n\nNext, you are presented with a page in which you can set up several options for your site:  \n- the ID of the site, which will end up as part of the site's address/URL;  \n- the Title of the site, which will be shown in the title of the browser window on each page;  \n- the main Language of the site;  \n- the Add-ons you want to activate for you site. Here, make sure that you check the box next to “**EEA Daviz**”.\n\nOnce you click the “Create Plone Site” button, you are presented with the default page of your site. Now you can perform changes and start using the EEA Daviz feature. To learn how to use it, navigate here: [EEA Daviz](http://eea.github.io/docs/IT-systems/eea.daviz/ \"EEA Daviz\").\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feea%2Feea.docker.daviz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feea%2Feea.docker.daviz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feea%2Feea.docker.daviz/lists"}