coller/README.md
Julien Riou 463e2e703b
All checks were successful
/ pre-commit (push) Successful in 3m20s
docs(README): Add docker compose example
Signed-off-by: Julien Riou <julien@riou.xyz>
2025-08-28 10:13:49 +02:00

72 lines
1.4 KiB
Markdown

# Coller
Simple self-contained pastebin solution written in Go.
# Description
Coller is a set of binaries:
- **collerd**: HTTP server to handle note management
- **coller**: CLI to create notes
- **copier**: CLI to download and decrypt notes (client-side decryption)
# Installation
## From source code
Requires [Go](https://go.dev/dl/).
```
git clone https://git.riou.xyz/jriou/coller.git
cd coller
make
sudo cp -p bin/* /usr/local/bin/
```
## Docker
### Standalone
```
git clone https://git.riou.xyz/jriou/coller.git
cd coller
docker build -t coller:latest .
docker run --rm --name collerd -p 8080:8080 coller:latest
```
Then go to http://localhost:8080 (website).
### Compose
Update the database password in:
* [collerd.json](docker/collerd.json)
* [db.env](docker/db.env)
Start the service:
```
docker-compose up -d
```
Then go to http://localhost:8080 (website).
## Ansible
See [ansible-role-coller](https://git.riou.xyz/jriou/ansible-role-coller).
# Usage and configuration
* [collerd](src/cmd/collerd/README.md)
* [coller](src/cmd/coller/README.md)
* [copier](src/cmd/copier/README.md)
# Contributions
Contributions are welcomed! Feel free to provide unit tests when possible. Lint
your code with `go fmt`. If you don't feel confident enough to contribute, feel
free to open an issue to describe the feature you would like to see implemented
or the problem you are facing.
# License
See [LICENSE](LICENSE).