PhotoCraft

Open-source, clean-room reimplementation of Adobe Photoshop in Rust, served as a WebAssembly web app on FreeBSD.

Version Tags

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.

Deployment

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

services:
  photocraft:
    image: "ghcr.io/daemonless/photocraft:latest"
    container_name: photocraft
    environment:
      - PUID=1000  # User ID for the nginx worker processes
      - PGID=1000  # Group ID for the nginx worker processes
      - TZ=UTC  # Timezone for the container
    ports:
      - "8080:80"
    # always (not unless-stopped) so FreeBSD's podman rc.d auto-starts it at boot
    restart: always

1
2
3
4
5
6

# .env

DIRECTOR_PROJECT=photocraft
PUID=1000
PGID=1000
TZ=UTC

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  photocraft:
    name: photocraft
    options:
      - container: 'args:--pull'
      - expose: '8080:80 proto:tcp'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'

1
2
3
4
5
6
7

# Makejail

ARG tag=latest

OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/photocraft:${tag}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

services:
  photocraft:
    name: photocraft
    image: "ghcr.io/daemonless/photocraft:latest"
    network:
      - mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC

Access at: http://localhost:8080

Setup Instructions

Everything runs in the browser. PhotoCraft is Rust compiled to WebAssembly; the container only serves static files. Files open through the browser's file picker and save as downloads, and nothing is stored server side, so there are no volumes.

Your work lives in the browser, not on the server. Preferences and any in-app library or cache belong to the browser profile that opened the app, per origin. Clearing site data, switching browsers, or reaching the app under a different hostname means starting empty. Export what you want to keep; the exported files are the backup, as with any desktop app.

Fonts. The browser build ships with only two fonts. PhotoCraft also lists the Japanese, Chinese and Arabic families from craft-fonts, which this image serves alongside the app; a family is downloaded the first time you pick it or open a document that uses it.

HTTPS. WebGPU and the clipboard need a secure context. Over plain HTTP the app falls back to WebGL2; put it behind your reverse proxy for the full experience.

Interactive Configuration

Parameters

Environment Variables

Ports

Need help? Join our Discord community.