Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/un-def/tinystash
A storage-less database-less file sharing service powered by OpenResty
https://github.com/un-def/tinystash
filesharing lua openresty telegram telegram-bot
Last synced: 29 days ago
JSON representation
A storage-less database-less file sharing service powered by OpenResty
- Host: GitHub
- URL: https://github.com/un-def/tinystash
- Owner: un-def
- License: mit
- Created: 2017-08-06T12:46:07.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-08-16T17:51:08.000Z (3 months ago)
- Last Synced: 2024-08-16T19:53:26.108Z (3 months ago)
- Topics: filesharing, lua, openresty, telegram, telegram-bot
- Language: Lua
- Homepage: https://tinystash.undef.im
- Size: 262 KB
- Stars: 22
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ᵗⁱⁿʸ[stash]
[](https://github.com/un-def/tinystash/releases)
[](https://github.com/un-def/tinystash/blob/master/LICENSE)
[](https://hub.docker.com/r/un1def/tinystash/)
A storage-less database-less file sharing service.
Written in [Lua][lua]. Powered by [LuaJIT][luajit] and [OpenResty][openresty].
## Introduction
**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.
It 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.
## Installing
### OpenResty
See [instructions][openresty-installation] on [OpenResty website][openresty].
### Lua packages
```shell
$ opm --cwd get $(cat requirements.opm)
```
## Configuring
```shell
$ cp config.example.lua config.lua
$ vi config.lua
```
## Setting up Telegram bot webhook
```shell
$ ./tinysta.sh webhook set
```
## Running
```shell
$ ./tinysta.sh run
```
## Quick deployment with Docker
1. Prepare `config.lua` as described above.
2. Set up Telegram bot webhook :
```shell
$ docker run --rm -it \
-v /path/to/config.lua:/opt/tinystash/config.lua \
un1def/tinystash webhook set
```
3. Run Docker container:
```shell
$ docker run -d \
--restart unless-stopped \
-v /path/to/config.lua:/opt/tinystash/config.lua \
-p 80:80 \
--name tinystash \
un1def/tinystash
```
## License
Source code is licensed under the [MIT License][license].
Source Sans Pro font is licensed under the [SIL Open Font License, Version 1.1][license-font-sourcesanspro].
Source Code Pro font is licensed under the [SIL Open Font License, Version 1.1][license-font-sourcecodepro].
[telegram]: http://telegram.org/
[lua]: https://lua.org/
[luajit]: https://luajit.org/
[openresty]: https://openresty.org/
[openresty-installation]: https://openresty.org/en/installation.html
[tinystash-site]: https://tinystash.undef.im/
[tinystash-bot]: https://t.me/tinystash_bot
[license]: https://github.com/un-def/tinystash/blob/master/LICENSE
[license-font-sourcesanspro]: https://github.com/un-def/tinystash/blob/master/static/OFL-SourceSansPro.txt
[license-font-sourcecodepro]: https://github.com/un-def/tinystash/blob/master/static/OFL-SourceCodePro.txt