{"id":18561659,"url":"https://github.com/athena-os/athena-core-docker","last_synced_at":"2026-03-19T05:04:24.726Z","repository":{"id":107041490,"uuid":"607250433","full_name":"Athena-OS/athena-core-docker","owner":"Athena-OS","description":"Official Athena OS docker core images.","archived":false,"fork":false,"pushed_at":"2025-11-15T15:58:37.000Z","size":136,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-16T11:23:46.281Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/athenaos/core","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Athena-OS.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"Athena-OS","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://www.paypal.com/donate/?hosted_button_id=MTYRF2NQT2BWA"]}},"created_at":"2023-02-27T16:11:00.000Z","updated_at":"2025-11-15T15:58:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"753c3a2b-79b1-4921-b896-3c03bf5c653b","html_url":"https://github.com/Athena-OS/athena-core-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Athena-OS/athena-core-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Athena-OS%2Fathena-core-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Athena-OS%2Fathena-core-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Athena-OS%2Fathena-core-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Athena-OS%2Fathena-core-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Athena-OS","download_url":"https://codeload.github.com/Athena-OS/athena-core-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Athena-OS%2Fathena-core-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28755045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T13:59:49.818Z","status":"ssl_error","status_checked_at":"2026-01-25T13:59:33.728Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2024-11-06T22:07:33.480Z","updated_at":"2026-01-25T16:01:38.060Z","avatar_url":"https://github.com/Athena-OS.png","language":"Dockerfile","funding_links":["https://github.com/sponsors/Athena-OS","https://www.paypal.com/donate/?hosted_button_id=MTYRF2NQT2BWA"],"categories":[],"sub_categories":[],"readme":"# Athena OS Docker Image\n\n![athena-banner](https://user-images.githubusercontent.com/83867734/221656804-51b13a4f-876b-4ca8-856e-288d2209a949.png)\n\n\nAthena OS container brings you to live a funny hacking experience in a containerized environment:\n\n* Select your favourite **InfoSec role** between **Bug Bounty Hunter**, **Red Teamer**, **OSINT Specialist** and **much more**\n* Play **Hack The Box** machines for improving your skills\n* Explore more than **2800+ hacking tools** retrievable by **Arch Linux** and **BlackArch** repositories\n* Make your **Capture The Flag** or **ethical hacking** activity efficient\n\nFind us at:\n\n* [Discord](https://discord.gg/DNjvQkb5Ad) - realtime support / chat with the community and the team.\n* [GitHub](https://github.com/Athena-OS) - view the source for all of our repositories.\n\n## Usage\n\n![image](https://github.com/Athena-OS/athena-core-docker/assets/83867734/c6d0be74-2014-4ab7-96d7-9b152d6f6561)\n\nAthena OS container has been developed in order to be run also by podman. The choice to use podman comes from its advantages over docker, one of most important: security.\n\nAccording to your preference, install `docker` and `docker-compose` packages or `podman` package for your Linux environment.\n\nIn case you are using podman, edit `/etc/containers/registries.conf` and add:\n```\n[registries.search]\nregistries = ['docker.io']\n```\nin order to allow podman to search for images in Docker Hub.\n\n### Hack The Box API Token\n\nAthena OS container allows you to learn and play on Hack The Box platform. It is possible to access to Hack The Box by using your App Token. Retrieve your App Token from the Hack The Box website in your Profile Settings.\n\n### Docker\n\nStore your App Token in a file called `htb-api-file` in your current directory, save and close it.\n\nYou can run the container by `docker-compose` (recommended) or `docker run`.\n\n#### docker-compose\n\nThe `docker-compose.yml` file should have the following content:\n```yaml\nversion: '3.4'\n\nservices:\n  athena:\n    image: athenaos/core\n    cap_add:\n      - net_admin\n    devices:\n      - /dev/net/tun\n    sysctls:\n      - net.ipv6.conf.all.disable_ipv6=0\n    secrets:\n       - source: htb-api\n    tmpfs:\n      - /run\n      - /tmp\n    restart: unless-stopped\n\nsecrets:\n  htb-api:\n    file: ./htb-api-file\n```\nand the `htb-api-file` must be in the same directory, otherwise you can change its path in `docker-compose.yml`.\n\nRun the container by:\n```\nsudo docker-compose run athena\n```\n\n#### docker run\n\n```bash\ndocker run -ti \\\n  --name athena \\\n  --volume ./htb-api-file:/run/secrets/htb-api:ro \\\n  --cap-add NET_ADMIN \\\n  --device /dev/net/tun \\\n  --sysctl net.ipv6.conf.all.disable_ipv6=0 \\\n  --restart unless-stopped \\\n  docker.io/athenaos/core:latest\n```\nor\n```\ndocker run -ti --name athena --volume ./htb-api-file:/run/secrets/htb-api:ro --cap-add NET_ADMIN --device /dev/net/tun --sysctl net.ipv6.conf.all.disable_ipv6=0 --restart unless-stopped docker.io/athenaos/core:latest\n```\n\nIn case you exit the container and need to re-enter, run:\n```\ndocker exec --user athena -ti athena /bin/zsh\n```\nIn case the container is not running, run:\n```\ndocker start athena\n```\n\nFor stopping the container, run:\n```\ndocker stop athena\n```\n\nFor deleting the container, run:\n```\ndocker container rm athena\n```\n\n### Podman\n\nStore your App Token in a file called `htb-api-file`, save and close it, and then run:\n\n```\npodman secret create htb-api htb-api-file\n```\nIn this manner, podman will store securely your API key. Now, you can delete the `htb-api-file` by `rm -rf htb-api-file`.\n\nYou can run the container by `podman run`.\n\n#### podman run\n\n```bash\npodman run -ti \\\n  --name athena \\\n  --secret htb-api \\\n  --cap-add NET_RAW \\\n  --cap-add NET_ADMIN \\\n  --device /dev/net/tun \\\n  --restart unless-stopped \\\n  docker.io/athenaos/core:latest\n```\nor\n```\npodman run -ti --name athena --secret htb-api --cap-add NET_RAW --cap-add NET_ADMIN --device /dev/net/tun --restart unless-stopped docker.io/athenaos/core:latest\n```\nPodman will automatically replicate `/etc/hosts` and `/etc/hostname` files of your host. For preventing this, add `--no-hosts` argument to the `podman run` command above.\n\nIn case you exit the container and need to re-enter, run:\n```\npodman exec --user athena -ti athena /bin/zsh\n```\nIn case the container is not running, run:\n```\npodman start athena\n```\n\nFor stopping the container, run:\n```\npodman stop athena\n```\n\nFor deleting the container, run:\n```\npodman container rm athena\n```\n### Default Credentials\n\n```\nathena:athena\n```\n\n## Parameters\n\nContainer images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `\u003cexternal\u003e:\u003cinternal\u003e` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.\n\n| Parameter | Function |\n| ---- | --- |\n| `--secret htb-api` | usage of App Token on the container |\n| `--cap-add=NET_RAW ` | needed for running ping command |\n| `--cap-add NET_ADMIN` | needed for running OpenVPN |\n| `--device /dev/net/tun` | needed for creating tun interface used by OpenVPN |\n\n## Updating Info\n\nBelow are the instructions for updating containers:\n\n### Via Podman Run\n\n* Update the image: `podman pull docker.io/athenaos/core:latest`\n* Stop the running container: `podman stop athena`\n* Delete the container: `podman rm athena`\n* Recreate a new container with the same podman run parameters as instructed above (if mapped correctly to a host folder, your `/config` folder and settings will be preserved)\n* You can also remove the old dangling images: `podman image prune`\n\n## Building locally\n\nIf you want to make local modifications to these images for development purposes or just to customize the logic:\n\n```bash\ngit clone https://github.com/Athena-OS/athena-core-docker.git\ncd athena-core-docker\ndocker buildx build \\\n  --no-cache \\\n  --network host \\\n  --pull \\\n  -t docker.io/athenaos/core:latest .\n```\n\nFor pushing to Docker Hub, first login to it:\n\n```bash\ndocker login\n```\n\nand then:\n\n```\ndocker push athenaos/core:latest\n```\n\nThe ARM variants can be built on x86_64 hardware using `multiarch/qemu-user-static`\n\n```bash\ndocker run --rm --privileged multiarch/qemu-user-static:register --reset\n```\n\nOnce registered you can define the dockerfile to use with `-f Dockerfile.aarch64`. This method has not been tested yet.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fathena-os%2Fathena-core-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fathena-os%2Fathena-core-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fathena-os%2Fathena-core-docker/lists"}