Set up the screenshot uploader (ShareX, Linux, and more)

Before you start

This guide connects a screenshot tool on your device to your account so every capture uploads instantly and copies a shareable link. It requires Image Host access — see Premium and billing.

Everything starts with one file: the uploader setup config. It contains a private upload key tied to your account.

Get your setup file

The .sxcu file is a small text file. ShareX reads it directly. On other platforms you will open it in a text editor to copy the upload key and endpoint (shown later).

1. 1Open Dashboard → Image Host.
2. 2Press Download uploader setup.
3. 3Save the file canna-sx.sxcu somewhere you can find it.
4. 4Keep this file private. Anyone with it can upload to your account.

Windows — install ShareX

1. 1Open getsharex.com in your browser.
2. 2Press Download and run the installer.
3. 3Follow the installer prompts and finish the installation.
4. 4Launch ShareX at least once so it is running.
5. 5ShareX is free, open source, and Windows-only.

Windows — connect ShareX to your account

If double-clicking does nothing, open ShareX → Destinations → Custom uploader settings → Import → From file, then choose the .sxcu file. Afterwards set it as the active destination under Destinations.

1. 1Make sure ShareX is installed and has been opened once.
2. 2Double-click the canna-sx.sxcu file you downloaded.
3. 3ShareX asks whether to set canna.sx as your active image and file uploader.
4. 4Press Yes to confirm.
5. 5ShareX now shows canna.sx Media Host under Destinations.

Windows — take and share your first capture

1. 1In ShareX, look at Capture → Region, or use the default shortcut Ctrl+Print Screen.
2. 2Select an area of your screen.
3. 3ShareX uploads it automatically and copies the link to your clipboard.
4. 4Paste the link anywhere to test it.

macOS — set up a custom uploader

ShareX does not run on macOS. You can still upload from the dashboard by dragging files in, or connect a Mac screenshot tool that supports custom/SXCU uploaders.

Tools such as uPic or ShareNix can upload to a custom endpoint. Configure them with the values from the next section.

Many Mac users simply use the built-in screenshot shortcut (Shift+Command+4) to save an image, then drag it into Dashboard → Image Host.

Linux — option A: ShareNix (reads your .sxcu)

1. 1Install ShareNix from its GitHub project (it accepts ShareX .sxcu config files).
2. 2Place your canna-sx.sxcu file where ShareNix expects its config, or pass it with the config flag.
3. 3Bind a keyboard shortcut to ShareNix's region-capture command in your desktop settings.
4. 4Take a capture — ShareNix uploads it and copies the returned link.

Linux — option B: Flameshot or a script

If you prefer Flameshot or your own script, upload to the endpoint directly. First open canna-sx.sxcu in a text editor and copy the key after "Bearer " in the Authorization header.

1. 1Endpoint: send a POST to https://canna.sx/api/image-host/upload
2. 2Header: Authorization: Bearer YOUR_API_KEY
3. 3Body: multipart form-data with the file in a field named file
4. 4Test with curl: curl -F "file=@/path/to/image.png" -H "Authorization: Bearer YOUR_API_KEY" https://canna.sx/api/image-host/upload
5. 5The response is JSON containing url (preview page), directUrl (raw file), and deletionUrl.
6. 6For Flameshot, pipe a capture to a small script that runs the curl command above and copies the url from the JSON response.

Mobile and other devices

There is no dedicated mobile app. On a phone or tablet, open Dashboard → Image Host in your browser and use the upload button to add photos and videos.

Any tool that can send an authenticated POST to the upload endpoint (above) will work, because the image host accepts standard multipart uploads.

Check it works and fix problems

1. 1Take a capture or upload a file.
2. 2Confirm a link was copied to your clipboard and opens your media.
3. 3Open Dashboard → Image Host to see the new item under Your uploads.
4. 4If nothing uploads, re-download the setup file and connect the tool again.