Deploy Mazanoke

Private in-browser image optimizer: compress, resize and convert images

Deploy Mazanoke

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

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

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
Letta Code Remote
Run a Letta Code agent 24/7. No inbound ports, just deploy.

Letta
52