JLCarveth / nutty

A very simple HTTP server, and a paste server implementation.

Nutty

A simple HTTP paste server - Contributions Welcome!

Nutty is a self-hostable paste server, allowing you to easily upload and share text files instantly.

Features

• A simple HTTP interface
• A simple Web interface (WIP)
• Public and private pastes
• Low memory footprint
• Burn-on-read - Pastes that can only be read once
• Automatic Syntax Highlighting

Installation

1. Make sure you have Deno installed on your system. If not, you can install it by following the instructions on the Deno website.
2. Clone the repository by running git clone https://github.com/JLCarveth/nutty.git.
3. Change into the cloned directory by running cd nutty.
4. Run the paste.ts file with Deno by running deno run -A --unstable paste.ts.

A simple systemd service can also be setup to handle stopping/starting Nutty:

[Unit]
Description=File pasting API

[Service]
ExecStart=/home/jlcarveth/.deno/bin/deno run -A --unstable paste.ts
Restart=always
User=jlcarveth
Group=jlcarveth
WorkingDirectory=/opt/paste
EnvironmentFile=/opt/paste/.env
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

Environment

Nutty depends on a couple of environment variables to be established before running.

Variable Name	Description	Example Values
TARGET_DIR	The directory where pastes will be stored.	/opt/paste/data
BASE_URL	The base URL at which the API can be accessed.	https://paste.mysite.com/api
SECRET_KEY	Used for signing JWTs. A secret key can be generated with openssl rand -base64 32	GDZ1FzBF18dtAk2enanqqxskVf5hptmPjy/pcBm384M=
PORT	The port to listen to. Default is 5335	5335
PUBLIC_PASTES	Whether to allow users to create pastes without an access token.	1,0,true,false
DEBUG	Logs incoming requests for debugging purposes.	1,0,true,false
DOMAIN	The domain used for the HTTP cookie, as well as the burn URLs.	paste.jlcarveth.dev

Usage

There is a simple client bash script which provides a simple example of using Nutty.

export TOKEN=$(curl https://paste.jlcarveth.dev/api/login -X POST -H "Content-Type: application/json" -d '{"email":"[e-mail]","password":"notmypassword"}')
export EMAIL="[e-mail]" # Email is used for signing PGP messages
uuid=$(cat file.txt | bash client.sh)

If the client runs successfully, a UUID associated with the new paste is returned. This paste can then be retrieved with a simple GET request:

curl $API_URL/$UUID -H "X-Access-Token: $TOKEN"