{"id":13469796,"url":"https://github.com/steveiliop56/getashell","last_synced_at":"2025-08-20T06:33:27.167Z","repository":{"id":228848372,"uuid":"774517735","full_name":"steveiliop56/getashell","owner":"steveiliop56","description":"Quickly spin up ssh shells from a dead simple UI 🐚","archived":true,"fork":false,"pushed_at":"2025-01-30T16:09:10.000Z","size":1124,"stargazers_count":64,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-16T06:44:41.336Z","etag":null,"topics":["develop","development","development-tools","docker","dockerized","linux","self-hosted","self-hosting","shell"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/steveiliop56.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2024-03-19T17:28:21.000Z","updated_at":"2025-07-20T02:46:58.000Z","dependencies_parsed_at":"2024-08-15T15:36:26.427Z","dependency_job_id":"e24fcb7e-9ca6-4968-8356-4818edc7d56f","html_url":"https://github.com/steveiliop56/getashell","commit_stats":null,"previous_names":["steveiliop56/getashell"],"tags_count":45,"template":false,"template_full_name":null,"purl":"pkg:github/steveiliop56/getashell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveiliop56%2Fgetashell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveiliop56%2Fgetashell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveiliop56%2Fgetashell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveiliop56%2Fgetashell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/steveiliop56","download_url":"https://codeload.github.com/steveiliop56/getashell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveiliop56%2Fgetashell/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271278882,"owners_count":24731900,"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","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"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":["develop","development","development-tools","docker","dockerized","linux","self-hosted","self-hosting","shell"],"created_at":"2024-07-31T16:00:16.413Z","updated_at":"2025-08-20T06:33:27.148Z","avatar_url":"https://github.com/steveiliop56.png","language":"TypeScript","funding_links":[],"categories":["Apps","TypeScript"],"sub_categories":["Development"],"readme":"\u003e [!WARNING]\n\u003e This project is no longer maintained, I decided to move forward since this was just a side project to test my skills. I have now moved on and I will not be adding any new features.\n\n## Get A Shell 🐚\n\nHave you ever wanted to just spin up a quick server that you can ssh into to test something real quick? Well with get a shell you can just spin up the UI select a distro and click _Get me a shell!_ and boom you have an ssh server with your specified distro. No need to spin up vms, run commands or anything harder than a click!\n\n![Preview](screenshots/app.png)\n\n### Installation ⏬\n\nThe installation is very simple and straight forward. You will firstly need to generate a super secure secret key with openssl. This can be done with this command:\n\n```Bash\nopenssl rand -base64 32\n```\n\nNow you simply need to take the output (which will be something like this: `0sWoIgLqYIskcvHbe4mENjj9btHKuOS3vDdYzhob6Mg=`) and put it in the [docker-compose](docker-compose.yml) file in the `SECRET_KEY` environment variable:\n\nFinally just start the app with this command:\n\n```Bash\ndocker compose up -d\n```\n\nAlternatively you can run the application with a simple docker run command, you will still need to run the openssl command and get the secret key though. Here is the full docker run command:\n\n```Bash\ndocker run -t -d --name getashell --restart unless-stopped -p 3000:3000 -v ./data:/app/data -v /var/run/docker.sock:/var/run/docker.sock -e SECRET_KEY=verylongsupersecretkeythatnobodywillsee --add-host host.docker.internal:host-gateway ghcr.io/steveiliop56/getashell:latest\n```\n\n\u003e Note 🗒️: If you don't want to run all of these commands you can install the app through [Runtipi](https://runtipi.io) which will configure everything for you.\n\n### Tutorials and Blog Posts ✏️\n\nThanks a lot to the blog posts below that wrote about GetAShell:\n\n- [Awesome Homelab](https://www.awesome-homelab.com/products/steveiliop56/getashell)\n- [Belginux](https://belginux.com/installer-get-a-shell-avec-docker/)\n  \n### Contributing ❤️\n\nAs I mentioned above I am fairly new to all these technologies and my code may be _probably is_ terrifying to look at. Any contributions on fixing my mistakes (lol) are welcome. In order to get started follow the Contribution Guide [here](CONTRIBUTING.md).\n\n### License 📜\n\nThe project is licensed under the GPL V3 License. You may modify, distribute and copy the code as long as you keep the changes in the source files. Any modifications you make using a compiler must be also licensed under the GPL license and include build and install instructions.\n\n### Credits\n\n[Nicolas](https://github.com/meienberger), thank you once again for helping me with workflow and docker stuff lol.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteveiliop56%2Fgetashell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteveiliop56%2Fgetashell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteveiliop56%2Fgetashell/lists"}