{"id":19811359,"url":"https://github.com/diging/giles-eco-docker","last_synced_at":"2026-06-11T11:31:22.665Z","repository":{"id":68005321,"uuid":"74414353","full_name":"diging/giles-eco-docker","owner":"diging","description":null,"archived":false,"fork":false,"pushed_at":"2023-02-08T20:06:06.000Z","size":765,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-28T18:46:39.472Z","etag":null,"topics":["docker","gile-ecosystem"],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/diging.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":"2016-11-21T23:16:06.000Z","updated_at":"2019-07-26T16:14:26.000Z","dependencies_parsed_at":"2023-05-21T19:00:17.244Z","dependency_job_id":null,"html_url":"https://github.com/diging/giles-eco-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/diging/giles-eco-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diging%2Fgiles-eco-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diging%2Fgiles-eco-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diging%2Fgiles-eco-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diging%2Fgiles-eco-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/diging","download_url":"https://codeload.github.com/diging/giles-eco-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diging%2Fgiles-eco-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34197393,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"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":["docker","gile-ecosystem"],"created_at":"2024-11-12T09:25:57.462Z","updated_at":"2026-06-11T11:31:22.648Z","avatar_url":"https://github.com/diging.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# giles-eco-docker\n\nThis repository holds Docker files for the Giles Ecosystem.\n\n## Set Up\nTo start up the Gile Ecosystem, do the following:\n\n1. Install docker and docker-compose.\n1. Clone this repository.\n1. Go to the giles-eco-docker directory.\n1. Go into either the `develop` or `latest_tag` folder. Starting Docker from the folder `develop` will pull the latest code from the develop branch of each component. This might result in an unstable version of the Giles Ecosystem. Starting Docker from the folder `latest_tag` will build the latest release version of each component. It is recommended to use the `latest_tag` folder.\n1. Create a folder called `data` with the following folders inside called: `imgs`, `others`, `pdfs`, `texts`, `mysql`, `dbs`. Inside the `dbs` folder create two more folders: `giles`, `september`, and `nepomuk`. The data folder will store all uploaded and extracted files. The `mysql` folder will contain your database files. If you use a version earlier than v0.5 for Giles or v0.6 for Nepomuk, the folder `db` will contain the database files.\n1. Run `docker-compose up`.\n\nNote: if you have installed the Giles Ecosystem docker containers previously for an older release, make sure to remove all containers and images before installing it again. Otherwise you might end up running the older release or with a combination of non-compatible component versions.\n\nThis will start the Giles Ecosystem docker environment. If you are using `latest_tag`, there will be 9 docker container running: Giles, Nepomuk, Cepheus, Cassiopeia, Andromeda (the Giles Ecosystem suite), Digilib (to serve up images, no exposed ports), MySQL, Apache Kafka and Zookeeper. If you are using `develop`, a 10th container will be started for September.\n\nThe following ports will be exposed:\n* `8080`: your Giles instance; the webapp is running at `http://locahost:8080/giles`\n* `8081`: your Nepomuk instance; the webapp is running at `http://locahost:8081/nepomuk`\n* `8082`: your Cepheus instance; the webapp is running at `http://locahost:8082/cepheus`\n* `8083`: your Cassiopeia instance; the webapp is running at `http://locahost:8083/cassiopeia`\n* `8084`: your Andromeda instance; the webapp is running at `http://localhost:8084/andromeda`\n\nIf you are using `develop`, there is an additional app running:\n* `8085`: your September instance; the webapp is running at `http://localhost:8085/september`\n\n## Configuration\n1. Once up and running, go to Giles and login as admin (bottom of the page) with admin/admin.\n1. Under \"System\" go to \"Social SigIn\" and provide client ids and secret for the sign in provider you want to use. In GitHub, for instance, go to your settings and register a new OAuth application.\n1. Under \"System\" go to \"Authentication\". Generate new signing secrets.\n1. Go to \"Apps\" in the main menu. Create a new token for Nepomuk by clicking on \"Register Apps\". You can leave the \"Identity Provider\" and (empty) \"Provider Client ID\" fields as they are.\n1. Login to Nepomuk as admin/admin (see list above for port numbers).\n1. Go to \"System Config\", and copy/paste the token that Giles generated.\n\n## User Accounts\n\nYou should now be able to sign in to Giles using your selected sign in provider. After the first time, you've signed in, log out again. Then sign in as admin and approve your user account under \"Users\" (the thumbs-up button at the end of a user row). You can make a user admin by clicking the key icon.\n\n## Testing the System\nTo test if the system works as expected, you can upload the provided [test file](https://github.com/diging/giles-eco-docker/blob/master/GraceHopperWikipedia.pdf). To see if the process finished successfully, go to \"Your Uploads\", click on the latest upload, then click on the document link. If processing has finished, you should see three badges indicating that image extraction, text extraction, and OCR are completed, and 11 pages should be listed with each three files (image file, extracted text file, and OCR result).\n\n## Upgrade Notes\n\n### Upgrading to Giles v0.5\n\nWith version v0.5, Giles started to use MySQL (or PostgreSQL) as backend. If you are upgrading from an earlier version of Giles to version v0.5, you will have to migrate existing data as follows:\n* Make sure Giles is running without exceptions with the new version.\n* Reregister Nepomuk with Giles under \"Apps\".\n* Go to http://localhost:8080/giles/admin/migrate\n* Enter the username of the user whose data you want to migrate. The username will be a combination of username and provider id. For example for GitHub: githubusername_github. Depending on how much data the user has uploaded, this might take a while.\n* Once the migration is done for a user, you will see some statistics about how many objects were migrated.\n\n### Upgrading to Nepomuk v0.6\n\nWith version v0.6, Nepomuk started to use MySQL (or PostgreSQL) as backend. If you are upgrading from an earlier version of Nepomuk to version v0.6, you will have to migrate existing data as follows:\n* Make sure Nepomuk is running without exceptions with the new version.\n* Go to http://localhost:8081/nepomuk/admin/migrate\n* Enter the username of the user whose data you want to migrate. The username will be a combination of provider id and provider user id. For example for GitHub: github_123456. Depending on how much data the user has uploaded, this might take a while.\n* Once the migration is done for a user, you will see some statistics about how many objects were migrated.\n\n## Notes\nIf `docker-compose up` fails with an error message such as `Could not transfer artifact org.apache.maven:maven-archiver:pom:2.6 from/to central (https://repo.maven.apache.org/maven2): Connection reset -\u003e [Help 1]`, this might simply be a connection issue and rerunning `docker-compose up` might fix it.\n\nIf Docker doesn't have enough memory, the individual containers might quietly fail (specifically with exit code 137) when you try to access one of the apps. To fix this issue simply give Docker more memory.\n\nIt can take a little while till all containers are up and running. If you upload a file and it is not processed but there are no error messages in the log, retry uploading the file after a couple of minutes.\n\n## Reporting Issues\nIf you run into issues setting up this docker environment or if the test file does not get processed successfully, please submit a [GitHub issue](https://github.com/diging/giles-eco-docker/issues). If the docker terminal shows exceptions or error messages, please include them in the ticket.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiging%2Fgiles-eco-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdiging%2Fgiles-eco-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiging%2Fgiles-eco-docker/lists"}