{"id":16614700,"url":"https://github.com/hyperupcall-archive/dockerized-mars","last_synced_at":"2025-10-29T18:31:57.573Z","repository":{"id":108432147,"uuid":"207740910","full_name":"fox-archives/dockerized-mars","owner":"fox-archives","description":"Configuration for spinning up MIPS Assembly and Runtime Simulator (MARS) in a Docker container","archived":true,"fork":false,"pushed_at":"2023-01-20T08:11:18.000Z","size":3892,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-17T16:53:47.788Z","etag":null,"topics":["docker","mips","mips-assembly","mips-simulator"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fox-archives.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":"2019-09-11T06:37:46.000Z","updated_at":"2024-02-03T09:12:23.000Z","dependencies_parsed_at":"2023-04-04T17:31:34.683Z","dependency_job_id":null,"html_url":"https://github.com/fox-archives/dockerized-mars","commit_stats":null,"previous_names":["fox-archives/dockerized-mars"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fox-archives%2Fdockerized-mars","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fox-archives%2Fdockerized-mars/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fox-archives%2Fdockerized-mars/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fox-archives%2Fdockerized-mars/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fox-archives","download_url":"https://codeload.github.com/fox-archives/dockerized-mars/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238874369,"owners_count":19545173,"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","mips","mips-assembly","mips-simulator"],"created_at":"2024-10-12T02:07:24.072Z","updated_at":"2025-10-29T18:31:57.054Z","avatar_url":"https://github.com/fox-archives.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dockerized MARS\n\n## Introduction\n\nThe MIPS Assembler and Runtime Simulator (MARS) is a good program for running (simulated) MIPS assemby code. If you want to get it up and running quickly (without installing Java on your host system), this is the tool for you. It contains configuration used to spin up MARS in a Docker container, whether you are running on GNU/Linux, macOS, or Windows.\n\n## Notes\n\nIf you are on GNU/Linux, this will only work if you are running an Xorg display server on your host machine. (Wayland and Mir are not directly supported).\n\n**Important**, the MARS program will only be able to see assembly programs that are contained in the `./dockerized-mars` directory. You will *not* be able to browse for files that are just anywhere on your computer. This is because we are [bind mounting](https://docs.docker.com/storage/bind-mounts) the [`./dockerized-mars` directory](https://github.com/eankeen/dockerized-mars/blob/8c19a71b7317b2c915d27be84f22470d2acfbff9/start.sh#L15) into the Docker container.\n\n## Setup\n\nDocker [must be installed](https://docs.docker.com/install).\n\n```sh\ngit clone https://github.com/eankeen/dockerized-mars\ncd dockerized-mars\nchmod +x ./start.sh\nsudo ./start.sh\n```\n\nRunning `start.sh` as sudo is required because connecting to the Docker daemon socket requires superuser privileges.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperupcall-archive%2Fdockerized-mars","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperupcall-archive%2Fdockerized-mars","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperupcall-archive%2Fdockerized-mars/lists"}