{"id":20570098,"url":"https://github.com/digibib/koha-docker","last_synced_at":"2025-05-09T19:30:42.960Z","repository":{"id":21114858,"uuid":"24415496","full_name":"digibib/koha-docker","owner":"digibib","description":"Koha docker image builders ","archived":true,"fork":false,"pushed_at":"2019-04-12T08:13:49.000Z","size":1061,"stargazers_count":53,"open_issues_count":5,"forks_count":18,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-21T18:52:12.294Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/digibib.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}},"created_at":"2014-09-24T13:15:10.000Z","updated_at":"2024-10-30T08:42:47.000Z","dependencies_parsed_at":"2022-08-25T12:41:24.801Z","dependency_job_id":null,"html_url":"https://github.com/digibib/koha-docker","commit_stats":null,"previous_names":[],"tags_count":87,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digibib%2Fkoha-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digibib%2Fkoha-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digibib%2Fkoha-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digibib%2Fkoha-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digibib","download_url":"https://codeload.github.com/digibib/koha-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253312069,"owners_count":21888565,"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-16T05:11:28.267Z","updated_at":"2025-05-09T19:30:42.604Z","avatar_url":"https://github.com/digibib.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"Koha Docker Container (WILL BE DEPRECATED SOON)\n===\n\nThis repo is no longer maintained by Deichman (Oslo Public Library)\n\nIf anyone wants to keep on developing this, we'd happily transfer ownership.\n\nIf interested in seeing our customized version of the Koha project, head to [OPL repo](https://gitlab.deichman.no/digibib/deichman).\n\nIt includes a koha + mysql setup with a heavily customized version of Koha, of course keeping the GPL license.\n\n\nOld info\n===\n\nThis project builds a [Docker](https://www.docker.com/) image containg an installation of the library system [Koha](http://koha-community.org/).\n\nMore documentation can be found on project [wiki](https://gitlab.deichman.no/digibib/koha-docker/wiki)\n\nDevelopment Quickstart for Deichman\n===\n\nThis is documentation on the development setup used in Deichman, but should be general enough to be used by anyone.\n\n\nClone the two projects\n====\n\n\n# 1. The Koha codebase\n\nhttps://github.com/Koha-Community/Koha  (upstream) the community code\n\n\n```\ngit clone https://gitlab.deichman.no/digibib/koha\n```\n\nWe keep master in sync with upstream and a local branch for each release with all our local patches on top (eg. release_17.11.01)\n\n```\ngit checkout release_17.11.01\n```\n\n# 2. The Koha Docker project\n\nhttps://gitlab.deichman.no/digibib/koha (origin)   deichman fork with local patches\n\nThis is the project for setting up Koha using docker in the various environments:\n* koha_dev   : development and testing of patches\n* koha_ci    : automated build used by gitlab runners for creating debian packages and a docker image\n* koha_build : using a production-ready docker image\n\n```\ngit clone https://gitlab.deichman.no/digibib/koha-docker\n```\n\n# 3. Run Development\n\nTODO: use Makefile instead\n* cd into docker-compose folder in koha-docker project (koha-docker/docker-compose)\n* start a docker container using code from git\n* mount locally checked out codebase as a volume inside the container\n\n## Build development docker image\n\nKOHAPATH must point to koha-docker root dir\n\n```\nsource docker-compose.env \u0026\u0026 KOHAPATH=.. docker-compose -f common.yml -f dev.yml build koha_dev\n```\n\n## Run development container\n\nKOHAPATH must point to koha-docker root dir\n\nREPO must point to koha code repo\n\n* this will run container in foreground with STDOUT and will stop and remove if you Ctrl-C\n* docker-compose run params explained\n* --rm (delete container when stopped)\n* --publish=8081:8081 ( publish ports so koha intra pages are accessible outside container )\n* --volume=xxx:yyy ( mounting of host code into container hostpath:containerpath )\n* --name ( optionally give container a name )\n* -d ( detatch )\n* --service-ports ( publish all ports from inside container )\n* -e (add environment variables e.g. KOHA_CONF=/etc/koha/sites/name/koha-conf.xml)\n* --entrypoint ( override entry point , e.g /bin/bash for a simple shell with no services running )\n\n```\nsource docker-compose.env \u0026\u0026 KOHAPATH=..  \\\n  docker-compose -f common.yml -f dev.yml run --rm --volume=/home/to/koha/repo:/kohadev/kohaclone --publish=8081:8081 koha_dev\n```\n\n# 4. Enter container\n\nContainer will have an autogenerated name (find it with `docker ps`) if not started with --name\n\nAdmin pages are at localhost:8081, with default admin (admin/secret) login\n\n```\ndocker exec -it dockercompose_koha_dev_run_1 bash\n```\n\n# 5. Useful commands inside container\n\nIt is a debian jessie distro, koha source code is mounted in /kohadev/kohaclone\n\nA lot of env vars exist used to configure system (use `env` for overview)\n\n* restart service\n```\n    supervisorctl -u$KOHA_ADMINUSER -p$KOHA_ADMINPASS restart \u003cservice\u003e \u003cservice\u003e\n      plack ( perl multiworker server, need to be restarted for koha to pick up changes in modules, systempreferences etc )\n      sip   ( sip server used by self checkout machines, door access, etc )\n      ncip_server ( interlibrary loan NCIP service )\n      zebra_server ( local Koha search index )\n```\n\n* enter mysql\n\n```\nkoha-mysql name\n```\n\n* Koha xml configuration file\n\n    KOHA_CONF=/etc/koha/sites/name/koha-conf.xml\n\n* run tests ( from /kohadev/kohaclone )\n\n```\nKOHA_CONF=/etc/koha/sites/name/koha-conf.xml PERL5LIB=. perl t/db_dependent/api/v1/illrequests.t\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigibib%2Fkoha-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigibib%2Fkoha-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigibib%2Fkoha-docker/lists"}