1
0
mirror of https://github.com/coalaura/up.git synced 2025-07-17 21:44:35 +00:00
Files
up/README.md

30 lines
1.2 KiB
Markdown
Raw Normal View History

2025-06-20 23:27:52 +02:00
2025-06-21 00:15:01 +02:00
UP is a simple file transfer tool that acts as a drop-in replacement for `scp` and `sftp`. It sends data over HTTPS for much faster uploads without any extra setup. Up uses your existing SSH keys and reads `~/.ssh/config` so you can keep working with the host aliases you already have.
2025-06-20 23:27:52 +02:00
## Why UP?
- Transfers are noticeably quicker than traditional `scp` or `sftp`.
- No setup: use the same SSH keys and host aliases you already have.
2025-06-21 00:15:01 +02:00
- Small single binary for sending and receiving.
2025-06-20 23:27:52 +02:00
## Quick Start
2025-06-20 23:40:37 +02:00
Pre-built binaries for common operating systems are available in the [releases](https://github.com/coalaura/up/releases/latest). Choose the download that matches your OS and architecture or build the latest development version yourself:
2025-06-20 23:27:52 +02:00
```bash
2025-06-21 00:15:01 +02:00
go build -o up .
2025-06-20 23:27:52 +02:00
```
Start the server (listens on port 7966) and then upload a file:
```bash
2025-06-21 00:15:01 +02:00
./up receive
2025-06-20 23:27:52 +02:00
2025-06-21 00:15:01 +02:00
./up send very_big.tar.xz localhost:7966
2025-06-20 23:27:52 +02:00
```
2025-06-21 00:15:01 +02:00
Uploaded files are stored under the server's `files/` directory. Up will prompt to trust the server's certificate on first use and will remember it afterwards. Up is built to work behind reverse proxies like nginx.
2025-06-20 23:27:52 +02:00
## License
2025-06-21 00:15:01 +02:00
This project is licensed under the GNU General Public License v3.0 License. See [LICENSE](LICENSE) for details.