{
  "manifest_version": "1",
  "slug": "garage-webui",
  "title": "Garage Web UI",
  "headline": "A web UI for Garage, on its own VM",
  "description": "Run garage-webui on an exe.dev VM next to your Garage: browse, upload, and manage buckets and keys, open only to the emails you list.",
  "category": "databases",
  "tags": [
    "garage",
    "garage-webui",
    "s3",
    "object storage",
    "admin ui",
    "file browser"
  ],
  "url": "https://exe.dev/deploy/garage-webui",
  "markdown_url": "https://exe.dev/deploy/garage-webui.md",
  "upstream": {
    "website": "https://github.com/khairul169/garage-webui",
    "source": "https://github.com/khairul169/garage-webui",
    "docs": "https://github.com/khairul169/garage-webui#readme",
    "license": "MIT"
  },
  "example_vm_name": "my-garage-ui",
  "time": "10 minutes",
  "stack": [
    {
      "name": "Garage Web UI 1.1",
      "detail": "khairul169/garage-webui, one Go binary run by systemd, on localhost",
      "port": 3909
    },
    {
      "name": "nginx",
      "detail": "Lets in only the emails you list, and hands the UI's S3 requests to the garage-s3 integration",
      "port": 8000
    },
    {
      "name": "Two exe.dev integrations",
      "detail": "garage-admin and garage-s3 reach the Garage VM, holding its admin token and exe.dev's key"
    },
    {
      "name": "Your Garage",
      "detail": "On its own VM, set up with the Garage page; nothing changes there"
    }
  ],
  "access": [
    {
      "url": "https://my-garage-ui.exe.xyz/",
      "who": "private",
      "what": "the web UI, for the exe.dev emails you list"
    }
  ],
  "inputs": [
    {
      "name": "GARAGE_VM",
      "description": "the name of the VM that runs Garage, such as my-garage"
    }
  ],
  "delivers": [
    "Garage Web UI at `https://my-garage-ui.exe.xyz/`, open only to the exe.dev emails in `~/garage-webui/allowed-emails`.",
    "Buckets, keys, permissions, and files of your Garage VM, browsed and changed from the browser.",
    "An admin token that expires in a year and can't create other tokens or change the cluster layout.",
    "No secrets on this VM. The admin token and exe.dev's key live in two exe.dev integrations, which add them at the edge."
  ],
  "owner_runs_after": [
    "ssh exe.dev share add my-garage-ui teammate@example.com   # then add them to allowed-emails",
    "ssh exe.dev integrations remove garage-admin   # cut the UI off from Garage"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=GARAGE_VM%3D%3Cfill-this-in%3E%0A%0ASet%20up%20Garage%20Web%20UI%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Fgarage-webui.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20values%20at%20the%20top%20of%20this%20message%20are%20mine%3A%0A-%20GARAGE_VM%3A%20the%20name%20of%20the%20VM%20that%20runs%20Garage%2C%20such%20as%20my-garage%0AAsk%20me%20for%20any%20that%20still%20say%20%3Cfill-this-in%3E%20before%20you%20need%20them.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-garage-ui.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-garage-ui.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20Garage%20Web%20UI%20at%20%60https%3A%2F%2Fmy-garage-ui.exe.xyz%2F%60%2C%20open%20only%20to%20the%20exe.dev%20emails%20in%20%60~%2Fgarage-webui%2Fallowed-emails%60.%0A-%20Buckets%2C%20keys%2C%20permissions%2C%20and%20files%20of%20your%20Garage%20VM%2C%20browsed%20and%20changed%20from%20the%20browser.%0A-%20An%20admin%20token%20that%20expires%20in%20a%20year%20and%20can%27t%20create%20other%20tokens%20or%20change%20the%20cluster%20layout.%0A-%20No%20secrets%20on%20this%20VM.%20The%20admin%20token%20and%20exe.dev%27s%20key%20live%20in%20two%20exe.dev%20integrations%2C%20which%20add%20them%20at%20the%20edge.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20Follow%20%22Install%20by%0Ahand%22%20on%20this%20VM.%20The%20step%20%22Connect%20it%20to%20Garage%22%20runs%20on%20the%20owner%27s%0Acomputer%2C%20not%20here%3A%20give%20the%20owner%20those%20commands%20with%20GARAGE_VM%20and%20this%0AVM%27s%20name%20filled%20in%2C%20and%20wait%20until%20they%20say%20they%20ran%20them.%20Check%20with%0A%60curl%20-s%20https%3A%2F%2Freflection.int.exe.xyz%2Fintegrations%60%20that%20garage-admin%0Aand%20garage-s3%20are%20attached%20%28if%20the%20owner%20picked%20other%20names%2C%20use%20those%29.%0AThen%20continue%20with%20%22Point%20it%20at%20Garage%22%20and%20the%20checks.%0AAllow%20only%20the%20owner%27s%20email%2C%20read%20from%20the%20reflection%20integration%3B%20if%0Athat%20fails%2C%20ask%20the%20owner%20for%20it.%20Leave%20this%20VM%20and%20the%20Garage%20VM%20private%2C%0Aand%20don%27t%20change%20anything%20on%20the%20Garage%20VM.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open%20and%20these%20commands%2C%20which%20only%20I%20can%20run%2C%20from%20my%20own%20computer%20%28with%20this%20VM%27s%20name%20in%20them%29%3A%0A%20%20ssh%20exe.dev%20share%20add%20my-garage-ui%20teammate%40example.com%20%20%20%23%20then%20add%20them%20to%20allowed-emails%0A%20%20ssh%20exe.dev%20integrations%20remove%20garage-admin%20%20%20%23%20cut%20the%20UI%20off%20from%20Garage%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/garage-webui/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "GARAGE_VM=\u003cfill-this-in\u003e\n\nSet up Garage Web UI on this VM by following the exe.dev recipe at https://exe.dev/deploy/garage-webui.md?via=deploy from top to bottom.\n\nThe values at the top of this message are mine:\n- GARAGE_VM: the name of the VM that runs Garage, such as my-garage\nAsk me for any that still say \u003cfill-this-in\u003e before you need them.\n\nThe recipe's example VM name is my-garage-ui. This VM's name is the output of `hostname`: use it wherever the recipe writes my-garage-ui. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- Garage Web UI at `https://my-garage-ui.exe.xyz/`, open only to the exe.dev emails in `~/garage-webui/allowed-emails`.\n- Buckets, keys, permissions, and files of your Garage VM, browsed and changed from the browser.\n- An admin token that expires in a year and can't create other tokens or change the cluster layout.\n- No secrets on this VM. The admin token and exe.dev's key live in two exe.dev integrations, which add them at the edge.\n\nRead the whole recipe, including the closed details. Follow \"Install by\nhand\" on this VM. The step \"Connect it to Garage\" runs on the owner's\ncomputer, not here: give the owner those commands with GARAGE_VM and this\nVM's name filled in, and wait until they say they ran them. Check with\n`curl -s https://reflection.int.exe.xyz/integrations` that garage-admin\nand garage-s3 are attached (if the owner picked other names, use those).\nThen continue with \"Point it at Garage\" and the checks.\nAllow only the owner's email, read from the reflection integration; if\nthat fails, ask the owner for it. Leave this VM and the Garage VM private,\nand don't change anything on the Garage VM.\n\nFinish with the URLs I should open and these commands, which only I can run, from my own computer (with this VM's name in them):\n  ssh exe.dev share add my-garage-ui teammate@example.com   # then add them to allowed-emails\n  ssh exe.dev integrations remove garage-admin   # cut the UI off from Garage\n",
    "prompt_url": "https://exe.dev/deploy/garage-webui/prompt.txt"
  },
  "published": "2026-11-19",
  "updated": "2026-11-19",
  "verified": "2026-11-19",
  "related": [
    "garage",
    "s3-storage",
    "redis",
    "agent-secrets",
    "metabase",
    "mongodb"
  ]
}
