{"id":21285010,"url":"https://github.com/palw3ey/ye3tftp","last_synced_at":"2026-05-16T23:15:27.042Z","repository":{"id":210437619,"uuid":"726546994","full_name":"palw3ey/ye3tftp","owner":"palw3ey","description":"A docker TFTP server based on tftp-hpa and Alpine. Light, below 10 Mb. GNS3 ready.","archived":false,"fork":false,"pushed_at":"2024-09-29T23:10:31.000Z","size":43,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T05:14:33.395Z","etag":null,"topics":["32bit","64bit","alpine","arm","cisco","docker","gns3","raspberry","tftp-server","tftpd-hpa"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/palw3ey/ye3tftp","language":"Shell","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/palw3ey.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}},"created_at":"2023-12-02T17:43:22.000Z","updated_at":"2024-09-29T23:10:34.000Z","dependencies_parsed_at":"2024-03-10T14:26:31.959Z","dependency_job_id":"600faf74-3308-448b-8a20-5a194c406443","html_url":"https://github.com/palw3ey/ye3tftp","commit_stats":null,"previous_names":["palw3ey/ye3tftp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palw3ey%2Fye3tftp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palw3ey%2Fye3tftp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palw3ey%2Fye3tftp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palw3ey%2Fye3tftp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/palw3ey","download_url":"https://codeload.github.com/palw3ey/ye3tftp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243746201,"owners_count":20341203,"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":["32bit","64bit","alpine","arm","cisco","docker","gns3","raspberry","tftp-server","tftpd-hpa"],"created_at":"2024-11-21T11:17:51.278Z","updated_at":"2026-05-16T23:15:22.005Z","avatar_url":"https://github.com/palw3ey.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ye3tftp\n\nA container TFTP server based on tftp-hpa and Alpine. Light, below 10 Mb. GNS3 ready.\n\nThe /data folder is persistent.\n\n# Simple usage\n\n```bash\ndocker run -dt --name mytftp -e Y_CREATE=yes -e Y_CHMOD=777 palw3ey/ye3tftp\n```\n\n# Test\n\n-   From the host\n\n```bash\n# create a test file :\ndocker exec -it mytftp sh --login -c \"echo it_works \u003e /data/test.txt\"\n\n# get container IP :\ndocker inspect --format='{{.NetworkSettings.IPAddress}}' mytftp\n\n# install a tftp client\napt install tftp-hpa\n\n# get the test file through the tftp client\ntftp 192.168.9.150 69\n  get test.txt\n  quit\n\n# show the content of the test file\ncat test.txt\n```\n\n# HOWTOs\n\n- Mount to your host folder /home/tux/Downloads\n```bash\ndocker run -dt --name mytftp -v /home/tux/Downloads:/data -e Y_CREATE=yes -e Y_CHMOD=777 palw3ey/ye3tftp\n```\n\n- Map to your host port 1069\n```bash\ndocker run -dt --name mytftp -p 1069:69/udp -e Y_CREATE=yes -e Y_CHMOD=777 palw3ey/ye3tftp\n```\n\n# GNS3\n\nTo run through GNS3, download and import the appliance : [ye3tftp.gns3a](https://raw.githubusercontent.com/palw3ey/ye3tftp/master/ye3tftp.gns3a)\n\n## How to connect the docker container in the GNS3 topology ?\nDrag and drop the device in the topology. Right click on the device and select \"Edit config\".  \nIf you want a static configuration, uncomment the lines just below `# Static config for eth0` or otherwise `# DHCP config for eth0` for a dhcp configuration. Click \"Save\".  \nAdd a link to connect the device to a switch or router. Finally, right click on the device, select \"Start\".  \nTo see the output, right click \"Console\".  \nTo type commands, right click \"Auxiliary console\".  \n\n# Environment Variables\n\nThese are the env variables and their default values.\n\n| variables | format | default | description |\n| :- |:- |:- |:- |\n|Y_LANGUAGE | text | fr_FR | Language. The list is in the folder /i18n/ |\n|Y_DEBUG | yes/no | no | yes, Run tftpd with verbose (--verbosity 4) option |\n|Y_IP | IP address | 0.0.0.0 | IP address to listen to |\n|Y_PORT | port number | 69 | Port to listen to |\n|Y_CREATE | yes/no | no | yes, Allow new files to be created |\n|Y_CHMOD | integer permission | | chmod to apply to /data/ folder. Has no default value by default, this mean : *dont modify permission.* Useful number 444 or 777. |\n|Y_CHMOD_RECURSIVE | yes/no | no | apply chmod recursively, this mean : to all files and folder in /data/ |\n\n# Compatibility\n\nThe docker image was compiled to work on these CPU architectures :\n\n- linux/386\n- linux/amd64\n- linux/arm/v6\n- linux/arm/v7\n- linux/arm64\n- linux/ppc64le\n- linux/s390x\n\nWork on most computers including Raspberry Pi\n\n# Build\n\nTo customize and create your own images.\n\n```bash\ngit clone https://github.com/palw3ey/ye3tftp.git\ncd ye3tftp\n# Make all your modifications, then :\ndocker build --no-cache --network=host -t ye3tftp .\ndocker run -dt --name my_customized_tftp ye3tftp\n```\n# Documentation\n\n[tftpd man page](https://linux.die.net/man/8/tftpd)\n\n# Version\n\n| name | version |\n| :- |:- |\n|ye3tftp | 1.0.0 |\n|tftp-hpa | 5.2 |\n|alpine | 3.20.3 |\n\n\n# Changelog\n## [1.0.0] - 2023-12-02\n### Added\n- first release\n\n# ToDo\n\n- ~~need to document env variables~~ (2023-12-18)\n- add more translation files in i18n folder. Contribute ! Send me your translations by mail ;)\n\nDon't hesitate to send me your contributions, issues, improvements on github or by mail.\n\n# License\n\nMIT  \nauthor: palw3ey  \nmaintainer: palw3ey  \nemail: palw3ey@gmail.com  \nwebsite: https://github.com/palw3ey/ye3tftp  \ndocker hub: https://hub.docker.com/r/palw3ey/ye3tftp\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalw3ey%2Fye3tftp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpalw3ey%2Fye3tftp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalw3ey%2Fye3tftp/lists"}