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 ea6b6141d8
#3 fixed a minor bug in the error message reported when pasting a blacklisted mimetype
3 months ago
cli-script Added output param when downloading paste 3 months ago
data Merge branch 'master' of 3 months ago
src #3 fixed a minor bug in the error message reported when pasting a blacklisted mimetype 3 months ago
.gitignore Always keep meta files and support for archiving of pastes 1 year ago
Dockerfile First take on docker 1 year ago
LICENSE Changed license to MIT 1 year ago Updated README with information about mailing list 1 year ago Updated TODO 1 year ago
docker-compose.yml First take on docker 1 year ago


Simple personal pastebin and imagebin.


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

Posting a text file


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

Posting an image file (jpg/png)


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


You can provide the following options as POST fields:

Do not use syntax highlighting

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

Deletes the paste with the given ID.

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

Display paste

Displays a paste with the given ID.

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

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


Install local development environment

Requires: git, docker, docker-compose.

git clone
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
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.