Skip to main content

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.

Choose your setup

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)

  • Hostftp.mysite.com.
  • Port21.
  • 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.
  • Regionauto 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.

Stuck?

Email support@maxisnap.com with a screenshot of the Upload Settings screen (you can Maxisnap it 🙂) and a description of your hosting, and we'll write back with the exact config for your setup.