ShareX-Uploader

ShareX-Uploader

Docker app from ImFascinated's Repository

Overview

Easily upload screenshots and files to a simple CDN using ShareX.

ShareX Uploader

Easily upload screenshots and files to a simple CDN using ShareX.

Requirements

  • Docker (If using Docker installation method)
  • ShareX

Installation

  1. Copy the docker-compose.yml file to your server.
  2. Edit the docker-compose.yml file and change environment variables to what you need, and update ./uploads to where you want to store the files.
  3. Run docker-compose up -d to start the container.
  4. Go to where the files are stored and edit the variables in upload.php to your liking.
  5. Run docker-compose restart to restart the container.
  6. Go to Post Installation to configure ShareX.

Installation (Unraid)

  1. Install the container from Community Applications and then edit the variables in the container.
  2. Go to where the files are stored and edit the variables in upload.php to your liking.
  3. Restart the container.
  4. Go to Post Installation to configure ShareX.

Installation (Without Docker - Ubuntu)

This installation method is not recommended as I cannot provide instructions for every single Linux distribution. If you don't know what you're doing, use the Docker installation method.

  1. Verify that your web server has the GD library installed. If not, run sudo apt install php-gd to install it.
  2. Upload the upload.php file to your server.
  3. Edit the upload.php file to configure the script.
  4. Go to Post Installation to configure ShareX.

Post Installation

  1. Open ShareX and go to Destinations > Custom Uploader Settings.
  2. Click on Import > From URL and enter https://github.com/RealFascinated/sharex-php-uploader/raw/branch/master/sharex.sxcu.
  3. Edit the URL to your website's URL.
  4. Click on Test after you've edited the URL and it should return a URL. If it doesn't, check your settings or contact me.

Need Help?

If you require assistance, feel free to contact me via Discord at fascinated7.

Install ShareX-Uploader on Unraid in a few clicks.

Find ShareX-Uploader in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for ShareX-Uploader Review the template variables and paths Click Install

Requirements

ShareX (For Windows)

Categories

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/realfascinated/sharex-php-uploader:latest
Last Updated2026-07-17
First Seen2025-12-01

Runtime arguments

Web UI
http://[IP]:[PORT:80]
Network
bridge
Shell
bash
Privileged
false

Template configuration

FILES_LOCATIONPathrw

Where you want the uploaded files to be stored.

Target
/var/www/html
Value
/mnt/user/Storage/CDN
Max Upload SizeVariable

The max upload size of files in megabytes. Eg: 500M

Target
MAX_UPLOAD_SIZE
Value
500M
Upload SecretsVariable

You can add multiple secrets. Format: secret1,secret2,secret3

Target
UPLOAD_SECRETS
Value
set me
Upload DirectoryVariable

The upload directory (If you don't know what this is, ignore it)

Target
UPLOAD_DIR
Value
./
Use Random File NamesVariable

Use random file names instead of the original file name. (If this is enabled it will replace the file name given by ShareX with a random one)

Target
USE_RANDOM_FILE_NAMES
Value
true
Random File Name LengthVariable

The length of the random file name (if above setting is enabled)

Target
FILE_NAME_LENGTH
Value
8
Server PortPorttcp

The port to connect to the application on.

Target
80
Value
8087