{"id":15569460,"url":"https://github.com/rbanffy/vm370","last_synced_at":"2026-03-05T12:31:22.069Z","repository":{"id":22068986,"uuid":"93902533","full_name":"rbanffy/vm370","owner":"rbanffy","description":"Docker image for rbanffy/vm370","archived":false,"fork":false,"pushed_at":"2024-06-24T09:58:53.000Z","size":1244,"stargazers_count":18,"open_issues_count":8,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-11T19:02:23.150Z","etag":null,"topics":["docker","emulation","hercules","ibm","mainframe"],"latest_commit_sha":null,"homepage":null,"language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rbanffy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-06-09T22:54:08.000Z","updated_at":"2024-12-13T10:14:44.000Z","dependencies_parsed_at":"2022-09-15T18:50:11.278Z","dependency_job_id":"2ad40c65-38e1-4eef-a7fc-dbe27419ebfb","html_url":"https://github.com/rbanffy/vm370","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rbanffy%2Fvm370","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rbanffy%2Fvm370/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rbanffy%2Fvm370/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rbanffy%2Fvm370/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rbanffy","download_url":"https://codeload.github.com/rbanffy/vm370/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235048982,"owners_count":18927715,"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":["docker","emulation","hercules","ibm","mainframe"],"created_at":"2024-10-02T17:29:21.194Z","updated_at":"2025-10-02T23:34:55.322Z","avatar_url":"https://github.com/rbanffy.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vm370\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/rbanffy/vm370.svg)](https://hub.docker.com/r/rbanffy/vm370/)\n[![GitHub](https://img.shields.io/github/license/rbanffy/vm370.svg)](https://github.com/rbanffy/vm370)\n\nThis repo contains the files needed to build the Docker image for rbanffy/vm370.\n\n![Screenshot](https://raw.githubusercontent.com/wiki/rbanffy/vm370/screenshot.png)\n\n## Building the image\n\nBy default, we'll build the VM370 Six Pack image. To build it, run:\n\n```shell\ndocker build -t vm370 .\n```\n\nTo run the image you just built on an amd64 computer, use:\n\n```shell\ndocker run -it -p 3270:3270 -p 8081:8081 $USER/vm370:latest-amd64\n```\n\nAt this point, you can connect your terminals to localhost on port 3278. To\nget to the web console, connect to http://localhost:8081 using the credentials\nfor the MAINT user (as published in the Sixpack documentation).\n\n## Building an image with other OSs\n\nBy default we'll build based on Dockerfile-vm370. To select other Dockerfiles,\nset the variable OPERATING_SYSTEM.\n\n```shell\nOPERATING_SYSTEM=vm370ce make build\n```\n\n## Running from Docker Hub\n\nTo run the VM370 Six Pack image without building it locally, use:\n\n```shell\ndocker run -it -p 3270:3270 -p 8081:8081 rbanffy/vm370\n```\n\nMVS Tk4- uses port 8038 for the web console:\n\n```shell\ndocker run -it -p 3270:3270 -p 8038:8038 rbanffy/mvstk4\n```\n\n## Deploying it to a Docker Swarm\n\nThis image is intended to run as a service on a cluster. To create a vm370\nservice on your cluster, run:\n\n```shell\ndocker service create --name vm370 --publish 3270:3270 --publish 8081:8081 rbanffy/vm370\n```\n\nWhen the service is up and running, connecting a 3270 session to any node will\nget you to the VM370 welcome screen.\n\n### A warning\n\nThe web-based Hercules console is not working properly for the VM370 images at\nthe moment, but work correctly with MVS 3.8 Tk4- on port 8038.\n\nA more serious issue is that data is not persisted beyond the life of the\ncontainer, or when the workload is moved to a new node. Use it at your own\nperil (and, if you know how, help improving it).\n\n## About the environments\n\n### VM370 SixPack and VM370ce\n\nThese are VM/370 systems with numerous improvements, fixes, and extras. VM370ce is newer and has more functionality.\n\nBoth come preconfigured with multiple users:\n\n|Userid|Description|Password|\n|------|-----------|--------|\n|CMSUSER|Normal user|CMSUSER|\n|MAINT|Maintenance user|CPCMS|\n|OPERATOR|Operator user|OPERATOR|\n\nThe user MAINT can see the other users in the `USERS DIRECT` file.\n\n### MVSTk4\n\nThis is an MVS 3.8j (the last version of MVS that can be legally deployed without a license - and an actual mainframe), with numerous improvements, fixes, and extras.\n\nIt comes with some preconfigured users:\n\n|Userid|Description|Password|\n|------|-----------|--------|\n|HERC01|Fully Authorized|CUL8TR|\n|HERC02|Fully Authorized|CUL8TR|\n|HERC03|Standard user|PASS4U|\n|HERC04|Standard user|PASS4U|\n|IBMUSER|Emergency user|IBMPASS|\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frbanffy%2Fvm370","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frbanffy%2Fvm370","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frbanffy%2Fvm370/lists"}