WordCraft Web — Docker Image

A self-hosted browser build of WordCraft, an open-source word processor written in Rust.
Packaged as a static web application and published to GitHub Container Registry.

GHCR Docker Compose

Why this repository?

This repository provides a Docker image for the official WordCraft web application.

The goal is to make WordCraft easy to deploy on a self-hosted server such as Unraid, without having to build the application manually.

• Build the web application directly from the official upstream repository.
• Automatically publish the resulting Docker image to GitHub Container Registry (GHCR).
• Rebuild periodically to follow upstream changes.
• Provide a simple Docker Compose configuration.
• Make the image suitable for Unraid and other Docker environments.
• Keep the Docker packaging separate from the upstream application.

This repository is a packaging project only. It is not a fork of WordCraft and does not modify the upstream source code.

How it works

WordCraft is an open-source word processor written in Rust. Its web version runs in a modern browser through WebAssembly and uses an eframe/wgpu interface, with WebGPU and a WebGL2 fallback.

WordCraft provides a familiar word-processing workflow with a ribbon interface, styles, tables, page layout, references, review tools and document formatting. The upstream application reads and writes DOCX, and also supports formats such as ODT, RTF, HTML, Markdown, LaTeX and TXT. PDF export is also available in the application. WordCraft is currently in alpha, and document fidelity and feature depth are still evolving.

The Docker image:

• Serves the prebuilt WordCraft web application as static files using NGINX.
• Does not run a desktop session or remote desktop.
• Does not add a server-side document-processing engine.
• Does not provide server-side user accounts or centralized document storage.

Documents are opened through the browser and saved/exported through browser downloads. Preferences are stored in the browser's local storage; they are not persisted in a Docker volume. The container itself does not store users' documents.

Docker image

The image is published on GitHub Container Registry:

ghcr.io/mikapst/wordcraft-web:latest

Option 1 — Docker Compose (recommended)

Create a docker-compose.yml file:

services:
  wordcraft-web:
    image: ghcr.io/mikapst/wordcraft-web:latest
    container_name: wordcraft-web
    ports:
      - "8080:8080"
    restart: unless-stopped

Start the container:

docker compose up -d

Open WordCraft in your browser:

http://YOUR_SERVER_IP:8080

Useful Compose commands

View container logs:

docker compose logs -f

Update the image:

docker compose pull
docker compose up -d

Stop and remove the container:

docker compose down

The container listens on port 8080. No volume or environment variable is required by this static web image.

Option 2 — Run directly with Docker

Pull the image:

docker pull ghcr.io/mikapst/wordcraft-web:latest

Run the container:

docker run -d \
  --name wordcraft-web \
  --restart unless-stopped \
  -p 8080:8080 \
  ghcr.io/mikapst/wordcraft-web:latest

Then open:

http://YOUR_SERVER_IP:8080

Network access and reverse proxies

The container exposes an HTTP service on port 8080.

You can place it behind a reverse proxy such as Traefik or NGINX Proxy Manager to access it through a domain name and HTTPS.

For public access, use HTTPS through a reverse proxy rather than exposing the unencrypted HTTP endpoint directly to the Internet.

WordCraft uses browser graphics APIs. WebGPU and clipboard access require a secure context (HTTPS, or localhost); WebGL2 is used as a fallback when WebGPU is unavailable. The upstream application does not require Cross-Origin-Opener-Policy or Cross-Origin-Embedder-Policy.

The NGINX configuration serves WebAssembly files with the correct MIME type, enables gzip compression, disables caching for index.html and applies long-lived immutable caching to hashed JavaScript and WebAssembly assets.

Automated builds

The GitHub Actions workflow builds the web application from the official storytold/wordcraft repository and publishes the resulting image to GHCR.

The workflow also checks out the upstream storytold/craft-i18n repository at the exact revision recorded in WordCraft's craft-i18n.rev file. This embeds the upstream language catalogs and proofing data in the web build.

Published tags:

• latest — the most recent successful build.
• upstream-<commit> — the WordCraft upstream commit used for that build.

Supported image architectures:

• linux/amd64
• linux/arm64

Important: WordCraft is currently in alpha. The latest tag is mutable and may contain upstream changes or regressions. For a stable deployment, consider pinning a specific image digest.

The workflow has been prepared but must be validated by its first execution in GitHub Actions. Until that run succeeds, the build and publication process should be considered unverified.

Unraid Community Applications

This image can be used with Unraid through Docker Compose or a Community Applications template.

The Unraid template is maintained separately in the MikaPST/unraid-community-apps repository.

This repository contains the Docker image build and publication workflow; the Community Applications repository contains the Unraid-specific template.

Upstream project

WordCraft is an open-source, clean-room reimplementation of a modern word processor, written in pure Rust.

Its features include:

• DOCX document reading and writing.
• Text and paragraph formatting, styles, themes and lists.
• Tables, pictures, shapes, text boxes, headers and footers.
• Page layout, columns, page numbers and watermarks.
• References, table of contents, footnotes, citations and bibliography.
• Spelling and grammar tools, comments and track changes.
• Import and export for ODT, RTF, HTML, Markdown, LaTeX and TXT.
• PDF export and page image rendering.

The upstream project also provides native desktop applications, a command-line interface and MCP integrations. These are not included in this Docker image, which packages only the browser-based WebAssembly application.

• Source code: github.com/storytold/wordcraft
• Official website: getartcraft.com/apps/wordcraft
• Releases: GitHub Releases
• Web hosting guide: Hosting WordCraft for the web

This repository packages the upstream web application for Docker. It does not modify the upstream application.

License and attribution

WordCraft is dual-licensed under MIT or Apache-2.0, at your option. Copyright and required notices are maintained by the upstream project in its NOTICE file.

Bundled assets, fonts and language data may have their own licenses. Their authors, sources and licenses are documented by the upstream project in ATTRIBUTION.md and the relevant dependency repositories.

The WordCraft and ArtCraft names, logos and related brand assets are trademarks of the upstream project and are not covered by the software license.

The Docker packaging files in this repository are provided separately from the upstream application. Refer to the upstream repository for the complete license texts, notices and asset attributions.

Disclaimer

This is an independent community packaging project and is not affiliated with, endorsed by, or supported by the ArtCraft team.

All product names, trademarks and logos are the property of their respective owners.