From e8b0e3a4829b35c6f2f900691e56f4c036c114f0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?D=C3=A1niel=20Szab=C3=B3?= <25702868+szabodanika@users.noreply.github.com> Date: Mon, 11 Apr 2022 14:48:11 +0100 Subject: [PATCH] Updated README.MD with instructions --- README.MD | 24 +++++++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) diff --git a/README.MD b/README.MD index fc10d3a..db42eb2 100644 --- a/README.MD +++ b/README.MD @@ -4,17 +4,35 @@ MicroBin is a super tiny and simple self hosted pastebin app written in Rust. The executable is around 6MB and it uses 2MB memory (plus your pastas). -Features: +### Installation +Simply clone the repository, build it with `cargo build --release` and run the `microbin` executable in the created `target/release/` directory. It will start on port 8080. + +To install it as a service on your Linux machine, create a file called `/etc/systemd/system/microbin.service`, paste this into it with the value of `ExecStart` replaced with the actual path to microbin on your machine. + +``` +[Unit] +Description=MicroBin +After=network.target +[Service] +Type=simple +Restart=always +ExecStart=/home/pi/microbin/target/release/microbin +[Install] +WantedBy=multi-user.target +``` + +Then start the service with `systemctl start microbin` and enable it on boot with `systemctl enable microbin`. + +### Features - No CSS or JS, super lightweight and simple - Animal names instead of random numbers for pasta identifiers - Automatically expiring pastas - Never expiring pastas - Listing and manually removing pastas -Needed improvements: +### Needed improvements - Persisting pastas on disk (currently they are lost on restart) - Removing pasta after N reads - File uploads - URL shortening -![Screenshot](git/pasta.png) \ No newline at end of file