Void.cat

Free, simple file hosting

Features

• Profiles
• File bandwidth statistics
• Administration features
• File download paywall

Running

Use the docker image to run void.cat:

docker run --rm -it -p 8080:80 ghcr.io/v0l/void.cat/app:latest

Then open your browser at http://localhost:8080.

The first registration will be set as admin, so make sure to create your own account

Usage

Simply drag and drop your files into the dropzone, or paste your screenshots or files into the browser window.

From cli you can upload with curl:

export FILE=memes.jpg
curl -X POST \
  -H "V-Content-Type: $(file --mime-type -b $FILE)" \
  -H "V-Full-Digest: $(sha256sum -bz $FILE | cut -d' ' -f1)" \
  -H "V-Filename: $FILE" \
  --data-binary @$FILE \
  "https://void.cat/upload?cli=true"

Or you can create an alias function in ~/bash_aliases like so:

vcu() {
  echo "Uploading $1"
  curl -X POST \
    -H "V-Content-Type: $(file --mime-type -b $1)" \
    -H "V-Full-Digest: $(sha256sum -bz $1 | cut -d' ' -f1)" \
    -H "V-Filename: $1" \
    --data-binary @$1 \
    "https://void.cat/upload?cli=true"
  echo -e ""
}

Uploading from cli will simply become vcu memes.jpg

You can also upload files to your user account by specifying an API key in the curl command:

  -H "Authorization: Bearer MY_API_KEY"

This command will return the direct download URL only. To get the json output simply remove the ?cli=true from the url.

Development

To run postgres in local use:

docker run --rm -it -p 5432:5432 -e POSTGRES_DB=void -e POSTGRES_PASSWORD=postgres postgres -d postgres

To run MinIO in local use:

docker run --rm -it -p 9000:9000 -p 9001:9001 minio/minio -- server /data --console-address ":9001"