---
title: "Deploy Mazanoke"
description: "Private in-browser image optimizer: compress, resize and convert images"
category: "Other"
url: https://railway.com/deploy/mazanoke
---

# Deploy Mazanoke

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

**[Deploy Mazanoke on Railway](https://railway.com/template/mazanoke)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/mazanoke/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Mazanoke https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mazanoke.png

- **Source:** https://github.com/aalfath/mazanoke-railway-template
- **Health check:** /healthz
- **Public domain:** Yes

## Documentation

# 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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/mazanoke
