npaste is a simple pastebin for text and images, supporting end-to-end encryption using GPG.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Kim Grytøyr 4611431b50
#7 Fix interpolations in pug
19 小時之前
cli-script Bump version to 0.6.5 4 天之前
data Merge branch 'master' of src.grytoyr.io:kim/npaste 9 月之前
src #7 Fix interpolations in pug 19 小時之前
.gitignore Always keep meta files and support for archiving of pastes 1 年之前
Dockerfile First take on docker 1 年之前
LICENSE Changed license to MIT 1 年之前
README.md Updated README with information about mailing list 1 年之前
TODO.md Updated TODO 1 年之前
docker-compose.yml First take on docker 1 年之前

README.md

npaste

Simple personal pastebin and imagebin.

Endpoints

POST and DELETE requires authentication. Set your credentials in data/tokens.json.

Posting a text file

POST /

curl --basic --user user:pass -F "paste=@test.txt" "http://localhost:3000/"

Posting an image file (jpg/png)

POST /

curl --basic --user user:pass -F "paste=@image.jpg" "http://localhost:3000/"

Options

You can provide the following options as POST fields:

plain=1
Do not use syntax highlighting

age=X[y|d|h|m]
Set expiration time. X is an integer. Example: 1d will make the paste self destruct after one day. If no time unit is provided, it will be parsed as seconds. Be aware that pastes are deleted only once per minute.

Delete a paste

DELETE /<ID>
Deletes the paste with the given ID.

curl --basic --user user:pass -X DELETE -F "paste=@test.txt" "http://localhost:3000/someidhere"

Display paste

GET /<ID>
Displays a paste with the given ID.

GET /<ID>/
Displays a paste in raw format.

GET /<ID>/meta
Displays metadata about the paste.

Installation

Install local development environment

Requires: git, docker, docker-compose.

git clone https://git.grytoyr.io/npaste
cd npaste
docker-compose up

The server will be accessible via http://localhost:3000.

Install in production

Requires: git, docker.

Decide which version (git tag) to run and check out the tag.

git clone https://git.grytoyr.io/npaste
cd npaste
git checkout $TAG_NAME

Modify the values in data/config.production.json.

Build the docker image with (remember the dot at the end): docker build -t npaste:latest .

Run the container: docker run --init --name npaste_1 --restart=always --volume="$(pwd)/data:/home/node/app/data" --publish="3000:3000" -d npaste:latest

This will start the container and accept connections on port 3000. It’s advised to use nginx or another reverse proxy to add features such as TLS, etc.

Upgrading in production

Run git pull and checkout the tag you wish to upgrade to. Run the same build command (docker build etc...) as described in Install in production.

Upgrading will at this time lead to some downtime.

Stop and remove the container: docker stop npaste_1 && docker rm npaste_1

After the commands above are done, issue the run command (docker run etc...) as described in Install in production.

Discussion and feedback

If you have any questions, feedback or patches, use the mailing list.