{"id":17870134,"url":"https://github.com/pouriyajamshidi/oxipot","last_synced_at":"2025-03-21T13:31:25.935Z","repository":{"id":179719009,"uuid":"524186196","full_name":"pouriyajamshidi/oxipot","owner":"pouriyajamshidi","description":"Network Honeypot written in Rust","archived":false,"fork":false,"pushed_at":"2025-03-17T17:43:30.000Z","size":5578,"stargazers_count":11,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-17T18:44:11.478Z","etag":null,"topics":["honeypot","network","telnet"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pouriyajamshidi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["pouriyajamshidi"]}},"created_at":"2022-08-12T18:21:44.000Z","updated_at":"2025-03-17T17:43:32.000Z","dependencies_parsed_at":"2023-10-17T01:49:32.751Z","dependency_job_id":"cd0be104-b658-4a23-a52e-9b2b9a8a6913","html_url":"https://github.com/pouriyajamshidi/oxipot","commit_stats":null,"previous_names":["pouriyajamshidi/oxipot"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouriyajamshidi%2Foxipot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouriyajamshidi%2Foxipot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouriyajamshidi%2Foxipot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouriyajamshidi%2Foxipot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pouriyajamshidi","download_url":"https://codeload.github.com/pouriyajamshidi/oxipot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244141597,"owners_count":20404835,"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":["honeypot","network","telnet"],"created_at":"2024-10-28T10:12:18.768Z","updated_at":"2025-03-21T13:31:25.346Z","avatar_url":"https://github.com/pouriyajamshidi.png","language":"Rust","funding_links":["https://github.com/sponsors/pouriyajamshidi"],"categories":[],"sub_categories":[],"readme":"# Oxipot\n\n![oxipot_logo](artwork/oxipot_logo.jpeg)\n\n![Downloads](https://img.shields.io/github/downloads/pouriyajamshidi/oxipot/total.svg?label=DOWNLOADS\u0026logo=github)\n![Docker Pulls](https://img.shields.io/docker/pulls/pouriyajamshidi/oxipot)\n\nA network telnet `HoneyPot` written in Rust.\n\n## Features\n\n- Detect **IT**, **OT** and **IoT** bots 🤖\n- Capture IP and location information of bots, attackers and intruders trying to gain access to your network\n- In-memory (`volatile`) and database (`non-volatile`) IP and location information caching\n- Handles a lot of concurrent network connections\n- Rate-limits persistent intruders\n- Build a big username and password database for IT, OT and IoT (thanks to malicious actors)\n- Extremely resource friendly and efficient to run\n- Containerized for portability and better security\n- SSH support (TBD)\n\n## Run\n\n### Using Docker Compose\n\nThis is the recommended way since it will always makes sure the container remains up.\n\n1. Make the database directory:\n\n   ```bash\n   mkdir /var/log/oxipot\n   ```\n\n2. Start the container:\n\n   ```bash\n   docker compose up\n   ```\n\n\u003e Please note this example is using the new `compose` plugin and not `docker-compose`. Nonetheless, there should be no difference.\n\n### Using Docker\n\n1. Make the database directory:\n\n   ```bash\n   mkdir /var/log/oxipot\n   ```\n\n2. Map port 23 to oxipot's default port, 2223 and specify the directory you want the database to be stored in.\n\n   ```bash\n   docker run --name oxipot --rm -t -p 23:2223 -v /var/log/oxipot:/oxipot/db:rw oxipot:latest\n   ```\n\n### Using The Executable\n\nDirectly using the executable is not recommended. This method should be used only if you know your craft.\n\n1. Download [the executable](https://github.com/pouriyajamshidi/oxipot/releases/latest/download/oxipot.tar.gz).\n\n2. Extract the file:\n\n   ```bash\n   tar -zxvf oxipot.tar.gz\n   ```\n\n3. Make it executable:\n\n   ```bash\n   chmod +x oxipot\n   ```\n\n4. Make the database directory:\n\n   ```bash\n   mkdir db\n   ```\n\n5. Run it:\n\n   ```bash\n   ./oxipot\n   ```\n\n\u003e A folder named `db` will be created in the same directory that will host `oxipot.db` containing the intruder reports.\n\n## View The Report\n\nAfter a connection is made to the machine running `oxipot`, a **sqlite3** database is created that you can refer to in order to see who has connected to the machine and what credentials they have used.\n\nDepending on how you run `oxipot`, the location of the database will differ.\n\n- Using [docker compose](#using-docker-compose), the database will be located at `/var/log/oxipot/oxipot.db`.\n- Using [docker run](#using-docker), the database will be located at the directory the image was started at `/var/log/oxipot/oxipot.db` or a custom directory you have specified.\n- Using [the executable](#using-the-executable), the database will be located at the same directory as `oxipot`.\n\nUtilizing sqlite3, you can view the reports.\n\n1. Open the database:\n\n   ```bash\n   sqlite3 /var/log/oxipot/oxipot.db\n   ```\n\n2. Run your query:\n\n   ```sql\n   SELECT * FROM intruders;\n   ```\n\nThe result will be similar to:\n\n![oxipot_report](artwork/oxipot_example_report.png)\n\n## Disclaimer\n\nThis is a hobby project and work in progress prone to many changes. Run at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpouriyajamshidi%2Foxipot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpouriyajamshidi%2Foxipot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpouriyajamshidi%2Foxipot/lists"}