{"id":13646828,"url":"https://github.com/irods-contrib/metalnx-web","last_synced_at":"2025-04-21T21:31:38.901Z","repository":{"id":9328488,"uuid":"60564217","full_name":"irods-contrib/metalnx-web","owner":"irods-contrib","description":"Metalnx Web Application","archived":false,"fork":false,"pushed_at":"2025-03-24T21:17:38.000Z","size":10083,"stargazers_count":37,"open_issues_count":52,"forks_count":36,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-03-24T22:24:41.777Z","etag":null,"topics":["administration","docker","irods","metadata-management","metalnx-web"],"latest_commit_sha":null,"homepage":"https://metalnx.github.io/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/irods-contrib.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-06T22:09:55.000Z","updated_at":"2025-03-24T21:17:42.000Z","dependencies_parsed_at":"2025-01-07T17:49:32.657Z","dependency_job_id":"dae1a721-0bba-4372-8e91-201fe447a561","html_url":"https://github.com/irods-contrib/metalnx-web","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irods-contrib%2Fmetalnx-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irods-contrib%2Fmetalnx-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irods-contrib%2Fmetalnx-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irods-contrib%2Fmetalnx-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/irods-contrib","download_url":"https://codeload.github.com/irods-contrib/metalnx-web/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250136748,"owners_count":21380885,"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":["administration","docker","irods","metadata-management","metalnx-web"],"created_at":"2024-08-02T01:03:09.158Z","updated_at":"2025-04-21T21:31:38.874Z","avatar_url":"https://github.com/irods-contrib.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"![Metalnx Logo](docs/IMAGES/mlx_logo_blue.png)\n\nMetalnx is a web application designed to work alongside [iRODS](https://irods.org). It is a graphical user interface and serves as a client that authenticates to an existing iRODS Zone.\n\n![Metalnx 2.0.0 Screenshot](docs/IMAGES/metalnx2.0.0.png)\n\n\nThe preferred method of deployment is via Docker.\n\n## Deploying Packaged Metalnx via docker-compose\n\ndocker-compose.yml\n```\nversion: '3'\n\nservices:\n\n  metalnx:\n    image: irods/metalnx:latest\n    restart: always\n    volumes:\n      - ./metalnx-configuration:/etc/irods-ext\n    ports:\n      - 80:8080\n```\n\nand then the `./metalnx-configuration/metalnx.properties` file requires rodsadmin iRODS connection credentials.\n\nMetalnx will be available on port 80 of the docker host machine at `/metalnx`.\n\nThis configuration could be supplemented with an nginx (or other) reverse-proxy to put Metalnx port 80 (and the subpath `/metalnx`) behind https on 443.\n\nExamples of the metalnx-configuration can be found in [docker-test-framework/etc/irods-ext](./docker-test-framework/etc/irods-ext).\n\n## Deploying Packaged Metalnx via Docker Hub directly\n\n### Prepare the application\n\n[Configuration](CONFIGURATION.md) of the default application can change many things about how Metalnx looks and behaves.\n - Configuration of Zone information, and features to display\n - Theming with custom CSS/Logo\n\nCreate a copy of the default [docker-test-framework/etc/irods-ext](./docker-test-framework/etc/irods-ext) directory and update `metalnx.properties` and `metalnxConfig.xml`, and then run a container with the new configuration, probably with `--add-host` information due to Docker:\n```\ndocker run -d \\\n  -p 8080:8080 \\\n  -v `pwd`/mylocal-irods-ext:/etc/irods-ext \\\n  --add-host hostcomputer:172.17.0.1 \\\n  --name metalnx \\\n  irods/metalnx:latest\n```\n\nTo map a local directory with SSL certificates (self-signed or from a CA), the container will look in `/tmp/cert`:\n```\n -v `pwd`/mylocal-certs:/tmp/cert \\\n```\n\nThe login screen should appear when requested in a web browser:\n\n```\nhttp://x.x.x.x:8080/metalnx\n```\n\n\n\nOr...\n\n## Building Metalnx\n\nFrom source, the package will 'just build':\n```\nmake\n```\n\nThis will result in a new Docker image named `myimages/metalnx:latest` on your machine.\n\n## Deploying Built Metalnx\n\nIf you're deploying your own image (built just above):\n\n```\ndocker run -d \\\n  -p 8080:8080 \\\n  -v `pwd`/mylocal-irods-ext:/etc/irods-ext \\\n  --add-host hostcomputer:172.17.0.1 \\\n  --name metalnx \\\n  myimages/metalnx:latest\n```\n\n### More information\n\nMore documentation can be found in the [Docs](docs) directory.\n\n### Copyright and License\n\nCopyright © 2018-2021 University of North Carolina at Chapel Hill; 2015-2017, Dell EMC.\n\nThis software is provided under the [BSD-3 License](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firods-contrib%2Fmetalnx-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Firods-contrib%2Fmetalnx-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firods-contrib%2Fmetalnx-web/lists"}