VS Code in the browser with Claude Code and the craft apps, in one container
373
VS Code in the browser (code-server) with Claude Code and the Craft Apps extension, plus the five storytold craft apps (PhotoCraft, VectorCraft, LightCraft, FilmCraft, EffectCraft) and the craft-mcp relay. All of it runs in one container on one port, so one-click hosts can run it.
Open the address, sign in with the password, and click an app in the Craft view. The app opens in an editor panel. Then ask Claude Code in the panel next to it, for example "open VectorCraft and draw a gold star".
docker run -d -p 8080:8080 -v craft-home:/home/coder -e PASSWORD=choose-one hayone/craft-studio
# open http://localhost:8080
| Path on the port | What answers |
|---|---|
/ | code-server, behind its password |
/relay/ | the craft-mcp relay. The app pages and the coding agent meet here. |
/healthz | ok, for the host's health check |
The app pages are served inside the container only (127.0.0.1:4100/<app>/). The Craft Apps
extension shows them through code-server's port proxy, so code-server's password protects them too.
All settings are optional environment variables.
| Variable | What it does |
|---|---|
PUBLIC_URL | The address people open, for example https://studio.example.com. Railway, Render, Koyeb and Fly.io are detected without it. The default is http://localhost:$PORT. |
PASSWORD | The sign-in password. Without it, the first start makes one, saves it in /home/coder/.craft-studio/secrets.env and prints it in the log. HASHED_PASSWORD works too. |
AUTH | password (default) or none. Use none only behind another sign-in. |
PORT | The port (default 8080). |
PROJECT_DIR | The folder VS Code opens (default /home/coder/project). |
CRAFT_APP_URL | App pages somewhere else, for example http://craft-app-{app}:8080/. Without it, the pages inside the container are used. |
CRAFT_RELAY_URL, CRAFT_RELAY_TOKEN | A craft-mcp relay somewhere else, and one of its MINT_TOKENS. Without them, the relay inside the container is used. |
RELAY_UPSTREAM | With an outside relay: its address inside your network, for example craft-mcp:8080. The container then passes PUBLIC_URL/relay/ on to it. |
EMBED_ORIGINS | Editors that may frame the inside app pages (default PUBLIC_URL,vscode-webview://*). |
EXTENSIONS | More Open VSX extensions to install, separated by commas. |
UPDATE_EXTENSIONS | false keeps the installed Claude Code and Craft Apps versions. By default each start installs the newest ones. |
CLAUDE_CLI | false skips the claude command (the extension has its own copy). |
Keep /home/coder on a volume. Your projects, settings, extensions and the generated secrets live
there.
https:// or on localhost. On a server, put the
container behind HTTPS. One-click hosts do that for you.Source: hayone1/Docker_Images. Deploy buttons, Docker Compose and a Helm chart: hayone1/craft-studio.
Content type
Image
Digest
sha256:5bd6c872e…
Size
875.2 MB
Last updated
about 17 hours ago
docker pull hayone/craft-studio