{"id":21303113,"url":"https://github.com/bzon/docker-jboss-liferay","last_synced_at":"2025-07-12T01:37:01.351Z","repository":{"id":141940517,"uuid":"63121328","full_name":"bzon/docker-jboss-liferay","owner":"bzon","description":null,"archived":false,"fork":false,"pushed_at":"2016-07-30T19:01:34.000Z","size":185,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-22T08:28:39.073Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/bzon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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":"2016-07-12T02:56:03.000Z","updated_at":"2018-08-02T18:06:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"12f3f536-93a1-4f3b-8707-ad51e08bcf5d","html_url":"https://github.com/bzon/docker-jboss-liferay","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/bzon%2Fdocker-jboss-liferay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bzon%2Fdocker-jboss-liferay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bzon%2Fdocker-jboss-liferay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bzon%2Fdocker-jboss-liferay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bzon","download_url":"https://codeload.github.com/bzon/docker-jboss-liferay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243776710,"owners_count":20346353,"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-21T15:58:56.623Z","updated_at":"2025-03-15T18:46:02.532Z","avatar_url":"https://github.com/bzon.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/bzon/docker-jboss-liferay.svg?branch=master)](https://travis-ci.org/bzon/docker-jboss-liferay)\n# Overview\n\nA docker project for Liferay Enterprise installed on Jboss Enterprise Application Server.\n\n## Requirement  \n\n- Your *Subscription license file* for Liferay Enterprise 6.2 e.g *your_license_file.xml*. Without this you will not be able to proceed with the Liferay startup wizard.\n- Docker version 1.9 or higher.\n- Docker compose 1.6 or higher.\n\n## Quickstart Guide\n\nThis basic docker run command will spin up the Liferay container using Jboss' default H2 datasource.\n\n    docker run -d -p 9990:9990 -p 8080:8080 bzon/jboss-liferay:6.2-ee-sp12\n    \n## Advanced Guide - Running with an External Database\n\nAs of this writing, this Docker image is configured to cater MySql 5, Oracle 11g and Oracle12c databases as external datasource.\n\nYou should define your database type in the variable `JBOSS_AS_DB_DRIVER_NAME` and the only choices are:\n\n- mysql\n- oracle-11g\n- oracle-12c\n\nNote that these are hardcoded driver names that you can find in `resources/conf/standalone.xml.template`.\n\n*NOTE:* Leave this blank and Liferay will use the default H2 database.\n\n### Using MySQL Database\n\n- Go to the `compose-for-mysql` directory and run `docker-compose`.\n\n    ```bash\n    cd compose-for-mysql/\n    docker-compose up -d\n    ```\n\n- By default the docker-compose command will use the configuration from `mysql-sample.env` file. \n\n    ```bash\n    # Sample configuration if Liferay will use a MySQL database\n\n    JVM_XMX_SIZE=4096m\n    JVM_XMS_SIZE=4096m\n\n    # Not editable - mysql is hardcoded as the driver name in standalone.xml\n    JBOSS_AS_DB_DRIVER_NAME=mysql\n\n    # Not editable - This is the configured driver class for MySQL\n    PORTAL_EXT_DEFAULT_DS_DRIVER_CLASS=com.mysql.jdbc.Driver\n    \n    # Edit with caution\n    JBOSS_AS_DS_JNDI=java:jboss/LiferayMySQLPool\n    PORTAL_EXT_DEFAULT_DS_JNDI=java:jboss/LiferayMySQLPool\n    \n    # 'liferaydb' is the service name of mysql database in the docker compose file\n    # These values are also the defaults in the image. See the Dockerfile for reference.\n    JBOSS_AS_JDBC_URL=jdbc:mysql://liferaydb:3306/lportal\n    JBOSS_AS_DB_HOST=liferaydb\n    JBOSS_AS_DB_PORT=3306\n    JBOSS_AS_DB_USER=lportal\n    JBOSS_AS_DB_PASSWORD=lportal\n    JBOSS_AS_DB_NAME=lportal\n    \n    # Edit with your preference\n    JBOSS_AS_DS_POOL=LiferayMySQLPool\n    PORTAL_EXT_CONTEXT_ROOT=/liferay\n    ```\n\n### Using Oracle Database\n\nThis is an example how you can use an Oracle 12c Database instance as your datasource. The following scenario assumes that your database is on a different server.\n\n- Configure the `oracle12c-sample.env` file. \n\n    ```bash\n    # Sample configuration if Liferay will use an Oracle database\n    \n    JVM_XMX_SIZE=4096m\n    JVM_XMS_SIZE=4096m\n\n    # Not editable - Oracle is hardcoded as the driver name in standalone.xml\n    JBOSS_AS_DB_DRIVER_NAME=oracle-12c\n\n    # Not editable - This is the configured driver class for Oracle 12c database\n    PORTAL_EXT_DEFAULT_DS_DRIVER_CLASS=com.oracle.ojdbc7\n\n    # Edit with caution the jboss datasource format should be 'java:jboss/'\n    JBOSS_AS_DS_JNDI=java:jboss/LiferayOracle12cPool\n    PORTAL_EXT_DEFAULT_DS_JNDI=java:jboss/LiferayOracle12cPool\n\n    # Fillup with the correct database information\n    # 172.31.41.107 is the remote server where the oracle database instance is running\n    JBOSS_AS_JDBC_URL=jdbc:oracle:thin:@172.31.41.107:1521/ORACLEDB\n    JBOSS_AS_DB_HOST=172.31.41.107\n    JBOSS_AS_DB_PORT=1521\n    JBOSS_AS_DB_USER=SYSTEM\n    JBOSS_AS_DB_PASSWORD=ORACLEPWD\n    JBOSS_AS_DB_NAME=ORACLEDB\n\n    # Edit with your preference\n    JBOSS_AS_DS_POOL=LiferayOracle12cPool\n    PORTAL_EXT_CONTEXT_ROOT=/liferay\n    ```\n- Run docker-compose\n\n    ```bash\n    cd compose-for-oracle/\n    docker-compose up -d\n    ```\n\nIf what you have is an Oracle 11g database, you can create your own environment file. See `oracle11g-sample.env` file then modify or create a `docker-compose.yml` file with the following content.\n\n    services:\n      liferayapp:\n        image: bzon/jboss-liferay:6.2-ee-sp12\n        container_name: liferay\n        ports:\n          - \"8080:8080\"\n          - \"9990:9990\"\n        env_file:\n         - oracle11g-sample.env\n    \n## Your Access Information  \n\nDescription | Value\n------------ | -------------\nLiferay Application URL | *http://localhost:8080/liferay*  \nJboss Management Console | *http://localhost:9990/console*  \nJboss Administrator | *admin*  \nJboss Administrator Password | *admin123!*  \n\nThe page should display some Licensing issue and that you'll need to enter your Order ID.\n\n![LiferayHome](https://raw.githubusercontent.com/bzon/docker-jboss-liferay/master/img/no-license.png)\n\n## Enabling License\n\n  - Copy your license file inside the running Liferay container:\n\n    ```bash\n    # **docker cp** will copy the license.xml as root by default\n    docker cp license.xml liferay:/tmp/\n    ```\n  \n  - Transfer the license file to the deploy directory as jboss user:\n  - \n    ```bash\n    docker exec -it liferay cp /tmp/license.xml /opt/jboss/deploy/ \n    ```\n\n  - Observe the logs to see that the license file has been deployed successfully.\n  \n    ```bash\n    docker exec -it liferay cat  /opt/jboss/logs/liferay.$(date +%Y-%m-%d).log\n    16:36:45,270 INFO  [com.liferay.portal.kernel.deploy.auto.AutoDeployScanner][AutoDeployDir:204] Processing license.xml\n    16:36:45,276 INFO  [com.liferay.portal.kernel.deploy.auto.AutoDeployScanner][LicenseAutoDeployListener:?] Copying license for /opt/jboss/deploy/license.xml\n    16:36:45,308 INFO  [com.liferay.portal.kernel.deploy.auto.AutoDeployScanner][LicenseManager:?] Portal Development license validation passed\n    16:36:45,308 INFO  [com.liferay.portal.kernel.deploy.auto.AutoDeployScanner][LicenseDeployer:?] License registered\n    ``` \n\nIf successful, access the page again and you should now be able to proceed with the Liferay Wizard.  \n\n![LiferayHome](https://raw.githubusercontent.com/bzon/docker-jboss-liferay/master/img/with-license.png)\n\n# Building your own Docker Image\n\nThe Dockerfile was based from following this [Liferay installation guide for Liferay 6.2 on Jboss 7 AS] (https://dev.liferay.com/discover/deployment/-/knowledge_base/6-2/installing-liferay-on-jboss-7-1).  \n\nThis image will be built on top of a base Jboss image `bzon/jboss-eap:6.4.0-ga` from Docker hub. For more information about this build, please see [My Jboss EAP 6.4.0 Docker Project](https://github.com/bzon/docker-jboss/tree/master/jboss-eap-6.4).\n\n## Requirements\n\nDirectory and Files tree.\n\n```bash\nDockerfile\nresources/\n|__entrypoint.sh\n|__wait-for-it.sh\n|__instalers/\n   |__ liferay-portal-6.2-ee-sp12-20150804162203131.war\n   |__ liferay-portal-dependencies-6.2-ee-sp12.zip\n   |__ mysql-connector-java-5.1.39-bin.jar\n   |__ ojdbc6.jar\n   |__ ojdbc7.jar\n   |__ tomcat-juli.jar\n|__conf/\n   |__ portal-ext.properties.template\n   |__ server.policy\n   |__ standalone.conf\n   |__ standalone.xml.template\n   |__ com.liferay.portal.module.xml\n   |__ com.oracle.ojdbc6.module.xml\n   |__ com.oracle.ojdbc7.module.xml\n```\n\n## Artifacts \n\nAll of the artifacts in this table should be present under the `resources/installers` directory.\n\nArtifact | Download Source\n------------ | -------------\nliferay-portal-6.2-ee-sp12-20150804162203131.war | Liferay Subscription\nliferay-portal-dependencies-6.2-ee-sp12.zip | Liferay Subscription\nmysql-connector-java-5.1.39-bin.jar | http://dev.mysql.com/downloads/connector/j/\nojdbc6.jar | http://www.oracle.com/technetwork/apps-tech/jdbc-112010-090769.html/\nojdbc7.jar | http://www.oracle.com/technetwork/database/features/jdbc/jdbc-drivers-12c-download-1958347.html/\ntomcat-juli.jar (optional) | http://www.java2s.com/Code/Jar/t/Downloadtomcatjulijar.htm\n  \n## Liferay and Jboss Configuration\n\nConfiguration File | Description\n------------ | -------------\nentrypoint.sh | Entrypoint script that orchestrates how the container will launch upon `docker run`\nportal-ext.properties.template | A tokenised template of portal-ext.properties for Liferay related configurations.\nserver.policy | Jboss policy permission file.\nstandalone.conf | Jboss standalone.sh startup script's configuration for JAVA_OPTS.\nstandalone.xml.template | A tokenised template of Jboss standalone.sh configuration where Datasource and Liferay related stuffs are placed. This is passed as `-c standalone.xml` upon container launch by default.\ncom.liferay.portal.module.xml | Liferay dependencies module.xml file that corresponds with the Liferay dependencies from the Requirements table. It also contains the Jboss datasource dependency configuration for mysql.\ncom.oracle.ojdbc6.module.xml | Jboss datasource module.xml file that contains the dependency configuration for oracle jdbc 6 connector for Oracle 11g database.\ncom.oracle.ojdbc7.module.xml | Jboss datasource module.xml file that contains the dependency configuration for oracle jdbc 7 connector for Oracle 12c database.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbzon%2Fdocker-jboss-liferay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbzon%2Fdocker-jboss-liferay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbzon%2Fdocker-jboss-liferay/lists"}