Deploy Mazanoke
Private in-browser image optimizer: compress, resize and convert images
Just deployed
Deploy and Host Mazanoke on Railway
Mazanoke is an open-source image optimizer that runs in your browser. It compresses, resizes and converts images to JPG, PNG, WebP or ICO (and reads HEIC, AVIF, TIFF, GIF and SVG) on the visitor's own device, so pictures never leave it. Self-host it as a private alternative to "free" online compression sites for you, your family or your team.
About Hosting Mazanoke
Mazanoke is a static web app served by nginx, so hosting it means running one small container and giving it a public HTTPS address. This template builds from a GitHub repo that pins the official ghcr.io/civilblur/mazanoke image (v1.1.7) by digest and adds a short start script: nginx listens on Railway's port, and an open /healthz path serves Railway's health check. HTTP basic auth is on by default, with a generated password, so strangers can't use your instance. There is no database and no volume, because all processing happens in the browser and settings stay in each visitor's browser storage.
Common Use Cases
- Shrink photos before emailing them, uploading them to a website or sharing them in chat
- Convert HEIC photos from iPhones, or PNG screenshots, to JPG or WebP
- Give family, friends or a team a private image compressor that never uploads their files to a third party
Dependencies for Mazanoke Hosting
- The Mazanoke container (official image, built from this template's repo)
- A Railway public domain (created by the template)
Deployment Dependencies
- Mazanoke source and docs: https://github.com/civilblur/mazanoke
- Mazanoke v1.1.7 release: https://github.com/civilblur/mazanoke/releases/tag/v1.1.7
- Docker configuration (basic auth): https://github.com/civilblur/mazanoke/blob/main/docs/configuration.md
- Template repo: https://github.com/aalfath/mazanoke-railway-template
Implementation Details
After the deploy, open the service's Variables tab to find the login: USERNAME (default mazanoke) and the generated PASSWORD. To make the instance public with no login, delete USERNAME or PASSWORD and redeploy. The login protects the app page; static files and /healthz stay open, as they do upstream.
Updates: the Mazanoke version is pinned in the repo's Dockerfile. When a new release is published there, Railway shows an "update available" notice on your project, and you choose when to apply it. Read the repo's CHANGELOG.md first.
Why Deploy Mazanoke on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying Mazanoke on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
