{"id":17835667,"url":"https://github.com/bebatut/galaxy-beerdecoded","last_synced_at":"2026-01-11T05:47:38.416Z","repository":{"id":112930588,"uuid":"100925553","full_name":"bebatut/galaxy-beerdecoded","owner":"bebatut","description":"Galaxy for BeerDeCoded","archived":false,"fork":false,"pushed_at":"2017-11-21T15:39:17.000Z","size":1032,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-08T04:18:34.300Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bebatut.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":"2017-08-21T07:33:46.000Z","updated_at":"2019-03-25T14:00:57.000Z","dependencies_parsed_at":"2023-03-13T13:24:08.065Z","dependency_job_id":null,"html_url":"https://github.com/bebatut/galaxy-beerdecoded","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/bebatut%2Fgalaxy-beerdecoded","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bebatut%2Fgalaxy-beerdecoded/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bebatut%2Fgalaxy-beerdecoded/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bebatut%2Fgalaxy-beerdecoded/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bebatut","download_url":"https://codeload.github.com/bebatut/galaxy-beerdecoded/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246819786,"owners_count":20839095,"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-10-27T20:24:09.820Z","updated_at":"2026-01-11T05:47:38.408Z","avatar_url":"https://github.com/bebatut.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"Galaxy for BeerDeCoded\n===============\n\n[![Docker Repository on Quay](https://quay.io/repository/bebatut/galaxy-beerdecoded/status \"Docker Repository on Quay\")](https://quay.io/repository/bebatut/galaxy-beerdecoded)\n\n[BeerDeCoded](http://www.genome.beer/) is a participatory project investigate the microbial composition of a collection of commercial beers. The goal of the BeerDeCoded project is not only to extend the scientific knowledge about beer, but also to improve the public understanding of issues related to personal geno- mics, food technology, and their role in society.\n\nFor the data analysis, the BeerDeCoded project is using [Galaxy](https://galaxyproject.org/), inside a [Galaxy Docker flavor](http://bgruening.github.io/docker-galaxy-stable/) based on [ASaiM](http://asaim.readthedocs.io/en/latest/).\n\n# Usage\n\n## Requirements\n\nTo use Galaxy for BeerDeCoded, [Docker](https://www.docker.com/products/overview#h_installation) is required (except if you want to [setup and run the framework without using Docker](#installation-and-use-without-using-docker)). \n\nFor Linux users and people familiar with the command line, please follow the [very good instructions](https://docs.docker.com/installation/) from the Docker project. Non-Linux users are encouraged to use [Kitematic](https://kitematic.com), a graphical User-Interface for managing Docker containers.\n\n## Launch\n\n1. Starting the Docker container with Galaxy for BeerDeCoded: analogous to starting the generic Galaxy Docker image: \n\n    ```\n    $ docker run -d -p 8080:80 quay.io/bebatut/galaxy-beerdecoded\n    ```\n\n    Nevertheless, here is a quick rundown: \n\n    - `docker run` starts the Image/Container\n\n        In case the Container is not already stored locally, Docker downloads it automatically\n       \n    - The argument `-p 8080:80` makes the port 80 (inside of the container) available on port 8080 on your host\n\n        Inside the container a Apache web server is running on port 80 and that port can be bound to a local port on your host computer. \n        With this parameter you can access your Galaxy instance via `http://localhost:8080` immediately after executing the command above\n        \n    - `quay.io/bebatut/galaxy-beerdecoded` is the Image/Container name, that directs Docker to the correct path in the [Docker index](https://index.docker.io/u/bgruening/galaxy-rna-workbench/)\n    - `-d` will start the Docker container in Daemon mode. \n\n    \u003e A detailed discussion of Docker's parameters is given in the [Docker manual](http://docs.docker.io/). It is really worth reading.\n\n    The Docker container is run: Galaxy will be launched!\n\n    \u003e Setting up Galaxy and its components can take several minutes. You can inspect the state of the starting using:\n    \u003e ```\n    \u003e $ docker ps # to obtain the id of the container\n    \u003e $ docker logs \u003ccontainer_id\u003e\n    \u003e ```\n\n    The previous commands will configure, launch and populate Galaxy with the needed tools, workflows and databases. The instance will be accessible at [http://localhost:8080](http://localhost:8080).\n\n2. Installation of the databases once Galaxy is running\n\n    ```\n    $ docker exec \u003ccontainer_id\u003e run_data_managers\n    ```\n\n\n#### Workflows\n\nTo access to the workflows, you need to connect with the admin user (username: `admin@galaxy.org`, password: `admin`). And you will have access to the workflows in the 'Workflow' section (Top panel)\n\n#### Databases\n\nDatabases are automatically added to the Galaxy instance for MetaPhlAn2, HUMAnN2 and QIIME.\n\nSometimes the databases are not correctly seen by the tools. If it is the case, you need to force the connection between the tool and the database:\n\n- Connect with the admin user: \n    - username `admin@galaxy.org` \n    - password `admin`\n- Go to the 'Admin' section (Top panel)\n- Go to 'Local data' section (Left panel)\n- Click on `humann2_nucleotide_database`, `humann2_protein_database` or `metaphlan2_database` (depending on the database)\n- Click on the 'Reload button' on the top\n    \n    The table must be filled\n\nIf you want other databases for HUMAnN2 or QIIME, you can install them \"manually\":\n\n- Connect with the admin user: \n    - username `admin@galaxy.org` \n    - password `admin`\n- Go to the 'Admin' section (Top panel)\n- Go to 'Local data' section (Left panel)\n- Click on 'HUMAnN2 download' (or 'Download QIIME') and choose the database you want to import\n\n### Interactive session\n\nFor an interactive session, you can execute:\n\n```\n$ docker run -i -t -p 8080:80 quay.io/bebatut/galaxy-beerdecoded /bin/bash\n```\n\nand manually invokes the `startup` script to start PostgreSQL, Apache and Galaxy and download the need databases.\n\n\u003e For a more specific configuration, you can have a look at the [documentation of the Galaxy Docker Image](http://bgruening.github.io/docker-galaxy-stable/).\n\n### Data\n\nDocker images are \"read-only\". All changes during one session are lost after restart. This mode is useful to present ASaiM to your colleagues or to run workshops with it. \n\nTo install Tool Shed repositories or to save your data, you need to export the computed data to the host computer. Fortunately, this is as easy as:\n\n```\n$ docker run -d -p 8080:80 -v /home/user/galaxy_storage/:/export/ quay.io/bebatut/galaxy-beerdecoded\n```\n\nGiven the additional `-v /home/user/galaxy_storage/:/export/` parameter, Docker will mount the folder `/home/user/galaxy_storage` into the Container under `/export/`. A `startup.sh` script, that is usually starting Apache, PostgreSQL and Galaxy, will recognize the export directory with one of the following outcomes:\n\n- In case of an empty `/export/` directory, it will move the [PostgreSQL](http://www.postgresql.org/) database, the Galaxy database directory, Shed Tools and Tool Dependencies and various configure scripts to /export/ and symlink back to the original location.\n- In case of a non-empty `/export/`, for example if you continue a previous session within the same folder, nothing will be moved, but the symlinks will be created.\n\nThis enables you to have different export folders for different sessions - meaning real separation of your different projects.\n\n### Users \u0026 Passwords\n\nThe Galaxy Admin User has the username `admin@galaxy.org` and the password `admin`.\n\nThe PostgreSQL username is `galaxy`, the password `galaxy` and the database name `galaxy`.\nIf you want to create new users, please make sure to use the `/export/` volume. Otherwise your user will be removed after your Docker session is finished.\n\n### Stoping Galaxy\n\nOnce you are done with Galaxy, you can kill the container:\n\n```\n$ docker ps # to obtain the id of the container\n$ docker kill \u003ccontainer_id\u003e\n```\n\n\u003e The image corresponding to the container will stay in memory. If you want to clean fully your Docker engine, you can follow the [Docker Cleanup Commands](https://www.calazan.com/docker-cleanup-commands/).\n\n# Documentation\n\nAvailable tools and workflows in ASaiM framework (on which the current instance is based) are described in the documentation available at [http://asaim.readthedocs.org/](http://asaim.readthedocs.org/en/latest/framework/index.html).\n\n# Bug Reports\n\nAny bug can be filed in an issue [here](https://github.com/bebatut/galaxy-beerdecoded/issues).\n\n# License\n\nGalaxy for BeerDeCoded is released under Apache 2 License. See the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbebatut%2Fgalaxy-beerdecoded","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbebatut%2Fgalaxy-beerdecoded","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbebatut%2Fgalaxy-beerdecoded/lists"}