{"id":13500945,"url":"https://github.com/un-def/tinystash","last_synced_at":"2025-07-27T16:34:33.094Z","repository":{"id":85223331,"uuid":"99485837","full_name":"un-def/tinystash","owner":"un-def","description":"A storage-less database-less file sharing service powered by OpenResty","archived":false,"fork":false,"pushed_at":"2025-01-05T06:20:06.000Z","size":303,"stargazers_count":24,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-13T09:33:56.141Z","etag":null,"topics":["filesharing","lua","openresty","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://tinystash.undef.im","language":"Lua","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/un-def.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,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"un1def","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"custom":["https://tinystash.undef.im/donate"]}},"created_at":"2017-08-06T12:46:07.000Z","updated_at":"2025-02-24T21:17:06.000Z","dependencies_parsed_at":"2024-05-20T09:27:35.941Z","dependency_job_id":"92e4e5f4-0c19-459b-ac31-fd8fdcb8a6fa","html_url":"https://github.com/un-def/tinystash","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/un-def/tinystash","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Ftinystash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Ftinystash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Ftinystash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Ftinystash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/un-def","download_url":"https://codeload.github.com/un-def/tinystash/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Ftinystash/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267387117,"owners_count":24079176,"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-07-27T02:00:11.917Z","response_time":82,"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":["filesharing","lua","openresty","telegram","telegram-bot"],"created_at":"2024-07-31T22:01:20.367Z","updated_at":"2025-07-27T16:34:33.043Z","avatar_url":"https://github.com/un-def.png","language":"Lua","readme":"# ᵗⁱⁿʸ[stash]\n\n[![version](https://img.shields.io/github/tag/un-def/tinystash.svg?maxAge=3600\u0026style=flat-square\u0026label=version)](https://github.com/un-def/tinystash/releases)\n[![license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://github.com/un-def/tinystash/blob/master/LICENSE)\n[![Docker pulls](https://img.shields.io/docker/pulls/un1def/tinystash.svg?maxAge=3600\u0026style=flat-square)](https://hub.docker.com/r/un1def/tinystash/)\n\nA storage-less database-less file sharing service.\n\nWritten in [Lua][lua]. Powered by [LuaJIT][luajit] and [OpenResty][openresty].\n\n\n## Introduction\n\n**tiny[stash]** is a [website][tinystash-site] and a [Telegram bot][tinystash-bot] for file sharing. A key feature of the service is the fact that it does not actually store anything — all files are stored on Telegram file servers and proxied by the service. You might be familiar with this idea — there is a plenty of file sharing services that work this way. But **tiny[stash]** is going even further. In addition, it does not use any kind of database, all required information is encoded, encrypted and stored directly in a URL.\n\nIt is also undemanding in terms of machine resources. If it is possible to run the **nginx** server on some hardware, it'll probably be possible to run **tiny[stash]** too. It also does not require a lot of RAM or disk storage because all data are processed in a streaming fashion.\n\n\n## Installing\n\n### OpenResty\n\nSee [instructions][openresty-installation] on [OpenResty website][openresty].\n\n### Lua packages\n\n```shell\n$ opm --cwd get $(cat requirements.opm)\n```\n\n\n## Configuring\n\n```shell\n$ cp config.example.lua config.lua\n$ vi config.lua\n```\n\n\n## Setting up Telegram bot webhook\n\n```shell\n$ ./tinysta.sh webhook set\n```\n\n\n## Running\n\n```shell\n$ ./tinysta.sh run\n```\n\n\n## Quick deployment with Docker\n\n1. Prepare `config.lua` as described above.\n\n2. Set up Telegram bot webhook :\n```shell\n$ docker run --rm -it \\\n    -v /path/to/config.lua:/opt/tinystash/config.lua \\\n    un1def/tinystash webhook set\n```\n\n3. Run Docker container:\n```shell\n$ docker run -d \\\n    --restart unless-stopped \\\n    -v /path/to/config.lua:/opt/tinystash/config.lua \\\n    -p 80:80 \\\n    --name tinystash \\\n    un1def/tinystash\n```\n\n\n## License\n\nSource code is licensed under the [MIT License][license].\n\nSource Sans Pro font is licensed under the [SIL Open Font License, Version 1.1][license-font-sourcesanspro].\n\nSource Code Pro font is licensed under the [SIL Open Font License, Version 1.1][license-font-sourcecodepro].\n\n\n\n[telegram]: http://telegram.org/\n[lua]: https://lua.org/\n[luajit]: https://luajit.org/\n[openresty]: https://openresty.org/\n[openresty-installation]: https://openresty.org/en/installation.html\n[tinystash-site]: https://tinystash.undef.im/\n[tinystash-bot]: https://t.me/tinystash_bot\n[license]: https://github.com/un-def/tinystash/blob/master/LICENSE\n[license-font-sourcesanspro]: https://github.com/un-def/tinystash/blob/master/static/OFL-SourceSansPro.txt\n[license-font-sourcecodepro]: https://github.com/un-def/tinystash/blob/master/static/OFL-SourceCodePro.txt\n","funding_links":["https://ko-fi.com/un1def","https://tinystash.undef.im/donate"],"categories":["Lua"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fun-def%2Ftinystash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fun-def%2Ftinystash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fun-def%2Ftinystash/lists"}