stepview

Repository: jason/stepview · branch main · TypeScript

Summary

StepView: self-hosted in-browser 3D STEP file viewer — renders .step/.stp files via OpenCascade (WASM) and three.js, deployed as a Docker container on Unraid

Current status

Active. Synced from Gitea on 2026-05-29.

Documentation overview

Source: INSTALL.md

StepView — Unraid Installation Guide

This guide covers the full deployment path: building the Docker image via the Gitea CI runner, then installing and configuring the container through the Unraid Docker GUI.

Prerequisites
Build Pipeline — Gitea Actions
Unraid — Add the Registry
Unraid — Install the Container
Environment Variables Reference
Volume Paths Reference
First-Run Steps
Upgrading
Backups
Troubleshooting

1. Prerequisites

Requirement	Notes
Unraid 6.12 or later	Earlier versions work but UI steps may differ slightly
Gitea instance	Any version with Actions support (1.19+)
Gitea Actions runner	Registered to your Gitea instance, labeled `ubuntu-latest`
Docker runner image	`catthehacker/ubuntu:act-latest` (already in your workflow)
`REGISTRY_USER` secret	Set in Gitea repo → Settings → Secrets
`REGISTRY_TOKEN` secret	An access token with `package:write` scope on `registry.alwisp.com`

2. Build Pipeline — Gitea Actions

The workflow at .gitea/workflows/docker-build.yml runs automatically on every push to main. It builds the image and pushes it to:

registry.alwisp.com/<OWNER>/stepview:latest

Verify the secrets exist

In your Gitea repository, go to Settings → Secrets and Variables → Actions and confirm both of these are set:

Secret name	Value
`REGISTRY_USER`	Your registry username
`REGISTRY_TOKEN`	Registry access token (read/write)

…(truncated — see repo)

Notes

Project file auto-created from repo documentation.

2.5 KiB Raw Blame History