Maxisnap Studio · Setup
Own every screenshot you take.
You bought Studio — that means you can route uploads to a domain
you control (SFTP, FTP, S3, R2, or any HTTP endpoint) and host
the share pages on your own site with your own branding.
Choose the PHP dashboard for a branded library with access controls,
or use SFTP, FTP or an S3-compatible bucket for direct file uploads.
The Cloudflare R2 walkthrough
covers bucket uploads; R2 does not run the PHP dashboard.
You have a website already
Connect Maxisnap to hosting you already run
Open Maxisnap → Settings → Upload, click + Add,
and pick the server type that matches what you already have. Here's
the right field values for the four common setups.
SFTP / SSH (any Linux VPS, shared hosting with SSH)
Host — e.g. vps.mysite.com or the IP. Port — usually 22. Username — the Linux account you SSH in as. Password or SSH Key — key auth is
safer. Maxisnap supports RSA, Ed25519, and ECDSA keys. Remote Dir — where to drop files on the server,
e.g. /var/www/html/snaps. The directory must already
exist and the user must have write permission. URL Prefix — the public URL the file will live at,
e.g. https://mysite.com/snaps. Maxisnap appends the
filename, so the final share URL is
https://mysite.com/snaps/ms_abcd1234.png.
Trip-hazard: if you get a "connection refused"
error even though SSH works from your terminal, check that port
22 isn't blocked outbound on your ISP — a couple of corporate
networks block it. Port 2222 is a common alternative.
FTP / FTPS (cPanel, shared hosting, legacy hosts)
Host — ftp.mysite.com. Port — 21. Username / Password — the FTP credentials
your host emailed you. On cPanel, "Main Account" or a dedicated
FTP user you create in the FTP Accounts panel. Use TLS/SSL — tick this if your host supports FTPS.
If you don't know, leave it off. Plain FTP still works. Remote Dir — usually
public_html/snaps or
httpdocs/snaps. Confirm via your host's file manager. URL Prefix — where that directory is served from,
e.g. https://mysite.com/snaps.
Plain FTP sends passwords in the clear. Use FTPS if your host
supports it — and move to SFTP at your earliest chance.
S3 / Cloudflare R2 / any S3-compatible bucket
Endpoint — your S3 endpoint URL. For Cloudflare
R2 this is https://<account-id>.r2.cloudflarestorage.com.
For AWS S3 you can leave this blank. Region — auto for R2,
us-east-1 etc. for AWS. Bucket — the bucket name, e.g. my-snaps.
It must already exist. Key ID / Secret — bucket access credentials
with PutObject permission. In R2: R2 → Manage API
Tokens → Create Token → Object Read & Write. Key Prefix — optional subfolder inside the bucket,
e.g. 2026/. URL Prefix — the public URL the object resolves at.
For R2, you bind a custom domain in the dashboard (e.g.
https://cdn.mysite.com).
R2 gives you 10 GB free with no time limit + 1M Class A ops/month — enough for
~10,000 screenshots with room to spare. That's why we recommend it
over AWS.
Custom HTTP (your own upload endpoint)
If you've written a tiny upload endpoint on your own backend, point
Maxisnap at it:
Upload URL — your endpoint, e.g.
https://api.mysite.com/upload. Field Name — the multipart/form-data
field the file should arrive on. Most servers expect file. Auth Header — e.g. Bearer <your-token>.
Stored encrypted in the app's config. Response Key — the JSON key in your response that
contains the URL to share. If your endpoint returns
{"url":"https://..."}, set this to url.
If your endpoint follows the Maxisnap Dashboard contract, the
entire dashboard source code is yours to download and self-host —
see the Studio Dashboard download in Account settings.
Click Test Connection to verify and then
Save. Maxisnap will immediately use your new server
for all future uploads — you can switch back to Maxisnap Cloud at
any time in Settings.
Self-host the dashboard too
Studio also unlocks the dashboard source code. You can download a
drop-in bundle that renders your screenshot library at
https://yoursite.com/snaps/ with your branding —
not maxisnap.com at all.
In the app's Account settings, download the dashboard bundle from the Maxisnap Studio card. Open the offline Start Here guide to preview your dashboard and share pages as you choose colours, fonts, a logo, and an optional button.
Choose Lock in my branding and select your extracted Studio package folder when prompted. After you allow folder access, the guide updates its snaps folder and downloads a matching snaps.zip with the same branding and fonts.
If your browser cannot save to folders, download snaps.zip and extract it to replace the package's snaps folder. A ZIP download alone leaves that folder unchanged.
Upload the snaps folder to your website root, often public_html, or extract snaps.zip there. Open /snaps/ to finish setup.
Then use the setup wizard in the same Account
panel: paste your dashboard URL and an upload-capable personal code,
test the connection, and choose it as your upload target. The owner can
use the setup key. The dashboard stores files on its PHP host; it does
not automatically import files from your R2, SFTP or FTP destinations.