{"id":19005078,"url":"https://github.com/dhis2/dhis2-live","last_synced_at":"2025-04-22T18:51:13.630Z","repository":{"id":28625037,"uuid":"32143784","full_name":"dhis2/dhis2-live","owner":"dhis2","description":"DHIS 2 Live package","archived":false,"fork":false,"pushed_at":"2019-05-02T08:52:19.000Z","size":81,"stargazers_count":7,"open_issues_count":0,"forks_count":6,"subscribers_count":34,"default_branch":"master","last_synced_at":"2025-04-17T10:24:56.255Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dhis2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-13T08:34:35.000Z","updated_at":"2024-02-26T04:25:48.000Z","dependencies_parsed_at":"2022-08-02T16:30:41.863Z","dependency_job_id":null,"html_url":"https://github.com/dhis2/dhis2-live","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhis2%2Fdhis2-live","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhis2%2Fdhis2-live/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhis2%2Fdhis2-live/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhis2%2Fdhis2-live/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dhis2","download_url":"https://codeload.github.com/dhis2/dhis2-live/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250303551,"owners_count":21408613,"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","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":[],"created_at":"2024-11-08T18:25:59.907Z","updated_at":"2025-04-22T18:51:13.611Z","avatar_url":"https://github.com/dhis2.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DHIS 2 Live\n\nDHIS 2 Live package - creates an executable jar which contains jetty server classes\nand a simple tray icon controller. \n\n## How to build DHIS 2 Live\nBuild the JAR and executable file with the following command:\n\n```\nmvn clean package\n```\nPrevious command generated the JAR and executable files in the `target` folder.\n\n## Structure of the DHIS 2 Live folder\nNow, create a new folder at some location of your preference. It doesn't have to be inside the dhis2-live folder. This folder will contain the DHIS2-Live launcher. When the folder is created, make sure its content is following (read further how to achieve it):\n\n```\n/dhis2-live.jar\n/dhis2-live.exe\n/startup.bat (optional)\n/conf/\n/conf/dhis.conf\n/log/\n/webapps/\n/webapps/dhis\n```\n### Upgrading DHIS2 version\nThe `/webapps/dhis` folder should contain the uncompressed WAR file. This implies that you can update your Live package with a later DHIS 2 version by deleting the `/webapps/dhis` folder, placing the latest `dhis.war` file under `webapps` and decompressing it. This should create a new `dhis` folder within the `webapps` folder and the created folder should contain the decompressed files from the .war file.\n\n### Getting executable .jar files at the correct location\nYou can find the executable jar and exe files here:\n\n```\ntarget/dhis2-live-jar-with-dependencies.jar\ntarget/dhis2-live.exe\n```\n\nYou can rename the `dhis2-live-jar-with-dependencies.jar` file to `dhis2-live.jar` and place it under the appropriate folder. Do the same with the .exe file.\n\n### dhis.conf file\n`dhis.conf` file should have the same settings as a regular DHIS2 installation has. For example, look at the bottom of this Readme file.\n\n## How it works\nOn Windows, the application (`dhis2-live.exe`) will install an icon in your system tray or equivalent. On UNIX based systems (and eventually also on Windows), you can run a command `java -jar dhis2-live.jar` from command prompt. This will start the DHIS2 instance. \n\nIn the system tray, the color of the icon indicates the state of DHIS2 instance. Blue icon indicates that instance is not running. Orange indicates that instance starting. Green indicates that instance is up and running. To exit/stop the instance, right click the icon and select Exit.\n\n## dhis.conf sample\nA sample `dhis.conf` configured for PostgreSQL looks like the below. Note that you\nmust install PostgreSQL yourself as the database is not provided by this package.\n\n```\n# Hibernate SQL dialect\nconnection.dialect = org.hibernate.dialect.PostgreSQLDialect\n\n# JDBC driver class\nconnection.driver_class = org.postgresql.Driver\n\n# Database connection URL\nconnection.url = jdbc:postgresql:dev\n\n# Database username\nconnection.username = dhis\n\n# Database password\nconnection.password = dhis\n\n# Database schema behavior, can be validate, update, create, create-drop\nconnection.schema = update\n```\n## Jetty port\nThe default port that the embedded jetty server listens on is `8080`.  If this\nclashes with other services on your system it can be reconfigured by creating a\nfile `conf/jetty.port` which contains simply the desired server port, eg `8888`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhis2%2Fdhis2-live","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdhis2%2Fdhis2-live","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhis2%2Fdhis2-live/lists"}