{
  "manifest_version": "1",
  "slug": "rustfs",
  "title": "RustFS",
  "headline": "Self-host RustFS",
  "description": "Run RustFS, an Apache-licensed S3-compatible object store, on an exe.dev VM: a private console, scoped app keys, nightly backups, and MinIO moves.",
  "category": "databases",
  "tags": [
    "rustfs",
    "s3 compatible storage",
    "object storage",
    "minio alternative",
    "self-hosted s3",
    "rclone",
    "boto3"
  ],
  "url": "https://exe.dev/deploy/rustfs",
  "markdown_url": "https://exe.dev/deploy/rustfs.md",
  "upstream": {
    "website": "https://rustfs.com",
    "source": "https://github.com/rustfs/rustfs",
    "docs": "https://docs.rustfs.com",
    "license": "Apache-2.0"
  },
  "example_vm_name": "my-rustfs",
  "time": "10 minutes",
  "stack": [
    {
      "name": "RustFS 1.0.6",
      "detail": "rustfs/rustfs in Docker Compose, one node on one disk",
      "port": 9000,
      "data": "~/rustfs/data"
    },
    {
      "name": "RustFS console",
      "detail": "Buckets, users, and policies, behind exe.dev login",
      "port": 9001
    },
    {
      "name": "rc and rclone",
      "detail": "RustFS's admin CLI and rclone, for app keys, backups, and moves"
    },
    {
      "name": "Nightly backups",
      "detail": "Every bucket, user, and policy, to your bucket at another provider"
    }
  ],
  "access": [
    {
      "url": "https://my-rustfs.exe.xyz:9001/",
      "who": "private",
      "what": "the RustFS console, signed in with the root keys"
    },
    {
      "url": "https://my-rustfs.exe.xyz:9000/",
      "who": "private",
      "what": "the S3 API, for clients that send a VM token"
    }
  ],
  "inputs": [
    {
      "name": "OFFSITE_BUCKET",
      "description": "an empty bucket at another provider for the nightly backups ([get one](#get-a-bucket)), or `none` to keep them on the VM for now"
    },
    {
      "name": "OFFSITE_ENDPOINT",
      "description": "R2: `https://\u003cACCOUNT_ID\u003e.r2.cloudflarestorage.com`; Backblaze B2: `https://s3.\u003cregion\u003e.backblazeb2.com`; another RustFS: `https://\u003cvm\u003e.exe.xyz`; Amazon S3: leave empty"
    },
    {
      "name": "OFFSITE_REGION",
      "description": "`auto` for R2, the bucket's region for B2 and Amazon S3, `us-east-1` for RustFS"
    },
    {
      "name": "OFFSITE_ACCESS_KEY_ID",
      "description": "a key that can read and write that bucket, and nothing else"
    },
    {
      "name": "OFFSITE_SECRET_ACCESS_KEY",
      "description": "the key's secret"
    }
  ],
  "delivers": [
    "RustFS 1.0.6 on the VM's disk, with its own root keys, started at boot.",
    "The S3 API at `http://localhost:9000` on the VM and, with a VM token, at `https://my-rustfs.exe.xyz:9000/`.",
    "The RustFS console at `https://my-rustfs.exe.xyz:9001/`, behind exe.dev login.",
    "An `app` bucket and a key that can use only that bucket, in `~/rustfs/app.env`.",
    "Nightly backups of every bucket, user, and policy to a bucket off the VM, one restored and checked."
  ],
  "owner_runs_after": [
    "ssh exe.dev ssh-key generate-api-key --vm=my-rustfs --label=s3 --exp=90d",
    "ssh -N -L 9000:localhost:9000 my-rustfs.exe.xyz"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=OFFSITE_BUCKET%3D%3Cfill-this-in%3E%0AOFFSITE_ENDPOINT%3D%3Cfill-this-in%3E%0AOFFSITE_REGION%3D%3Cfill-this-in%3E%0AOFFSITE_ACCESS_KEY_ID%3D%3Cfill-this-in%3E%0AOFFSITE_SECRET_ACCESS_KEY%3D%3Cfill-this-in%3E%0A%0ASet%20up%20RustFS%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Frustfs.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20values%20at%20the%20top%20of%20this%20message%20are%20mine%3A%0A-%20OFFSITE_BUCKET%3A%20an%20empty%20bucket%20at%20another%20provider%20for%20the%20nightly%20backups%20%28%5Bget%20one%5D%28%23get-a-bucket%29%29%2C%20or%20%60none%60%20to%20keep%20them%20on%20the%20VM%20for%20now%0A-%20OFFSITE_ENDPOINT%3A%20R2%3A%20%60https%3A%2F%2F%3CACCOUNT_ID%3E.r2.cloudflarestorage.com%60%3B%20Backblaze%20B2%3A%20%60https%3A%2F%2Fs3.%3Cregion%3E.backblazeb2.com%60%3B%20another%20RustFS%3A%20%60https%3A%2F%2F%3Cvm%3E.exe.xyz%60%3B%20Amazon%20S3%3A%20leave%20empty%0A-%20OFFSITE_REGION%3A%20%60auto%60%20for%20R2%2C%20the%20bucket%27s%20region%20for%20B2%20and%20Amazon%20S3%2C%20%60us-east-1%60%20for%20RustFS%0A-%20OFFSITE_ACCESS_KEY_ID%3A%20a%20key%20that%20can%20read%20and%20write%20that%20bucket%2C%20and%20nothing%20else%0A-%20OFFSITE_SECRET_ACCESS_KEY%3A%20the%20key%27s%20secret%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-rustfs.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-rustfs.%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-%20RustFS%201.0.6%20on%20the%20VM%27s%20disk%2C%20with%20its%20own%20root%20keys%2C%20started%20at%20boot.%0A-%20The%20S3%20API%20at%20%60http%3A%2F%2Flocalhost%3A9000%60%20on%20the%20VM%20and%2C%20with%20a%20VM%20token%2C%20at%20%60https%3A%2F%2Fmy-rustfs.exe.xyz%3A9000%2F%60.%0A-%20The%20RustFS%20console%20at%20%60https%3A%2F%2Fmy-rustfs.exe.xyz%3A9001%2F%60%2C%20behind%20exe.dev%20login.%0A-%20An%20%60app%60%20bucket%20and%20a%20key%20that%20can%20use%20only%20that%20bucket%2C%20in%20%60~%2Frustfs%2Fapp.env%60.%0A-%20Nightly%20backups%20of%20every%20bucket%2C%20user%2C%20and%20policy%20to%20a%20bucket%20off%20the%20VM%2C%20one%20restored%20and%20checked.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20from%20top%20to%20bottom%3A%20Docker%2C%20the%20root%20keys%2C%0ARustFS%20in%20Docker%20Compose%2C%20rc%20and%20the%20app%20bucket%2C%20rclone%20and%20the%20backup%0Atimer%2C%20and%20the%20backup%20test.%20The%20walkthrough%20sections%20are%20for%20the%20owner%0Aafterwards%3A%20don%27t%20make%20the%20VM%20public%2C%20change%20its%20shared%20port%2C%20move%20data%0Afrom%20MinIO%2C%20or%20run%20the%20Restore%20or%20Update%20instructions%20during%20setup.%0AWrite%20the%20owner%27s%20OFFSITE_%2A%20values%20into%20~%2Frustfs%2Foffsite.env%20without%0Aprinting%20the%20secret.%20If%20OFFSITE_BUCKET%20is%20%60none%60%20or%20the%20owner%20has%20no%0Abucket%20yet%2C%20skip%20%22Give%20the%20backups%20a%20bucket%22%2C%20run%20the%20%22No%20bucket%20yet%3F%22%0Ablock%20instead%20of%20the%20one%20before%20it%2C%20and%20tell%20the%20owner%20that%20the%20backups%0Astay%20on%20the%20VM%20until%20they%20add%20a%20bucket%20%28%22Add%20a%20bucket%20later%22%29.%20If%20the%20bucket%0Aalready%20holds%20a%20%60rustfs%2F%60%20folder%2C%20stop%20and%20ask%20the%20owner%3A%20it%20may%20be%0Aanother%20VM%27s%20backup%2C%20which%20the%20nightly%20sync%20would%20overwrite.%0ANever%20overwrite%20an%20existing%20~%2Frustfs%2F.env%20or%20~%2Frustfs%2F%2A.env%20file.%0ADelete%20only%20the%20scratch%20bucket%20and%20the%20scratch%20restore%20the%20backup%20test%0Acreates.%20Leave%20the%20VM%20private%20and%20do%20not%20reboot.%20Don%27t%20paste%20keys%20into%0Athe%20chat%3B%20say%20they%20are%20in%20~%2Frustfs%2F.env%20and%20~%2Frustfs%2Fapp.env.%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%20ssh-key%20generate-api-key%20--vm%3Dmy-rustfs%20--label%3Ds3%20--exp%3D90d%0A%20%20ssh%20-N%20-L%209000%3Alocalhost%3A9000%20my-rustfs.exe.xyz%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/rustfs/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "OFFSITE_BUCKET=\u003cfill-this-in\u003e\nOFFSITE_ENDPOINT=\u003cfill-this-in\u003e\nOFFSITE_REGION=\u003cfill-this-in\u003e\nOFFSITE_ACCESS_KEY_ID=\u003cfill-this-in\u003e\nOFFSITE_SECRET_ACCESS_KEY=\u003cfill-this-in\u003e\n\nSet up RustFS on this VM by following the exe.dev recipe at https://exe.dev/deploy/rustfs.md?via=deploy from top to bottom.\n\nThe values at the top of this message are mine:\n- OFFSITE_BUCKET: an empty bucket at another provider for the nightly backups ([get one](#get-a-bucket)), or `none` to keep them on the VM for now\n- OFFSITE_ENDPOINT: R2: `https://\u003cACCOUNT_ID\u003e.r2.cloudflarestorage.com`; Backblaze B2: `https://s3.\u003cregion\u003e.backblazeb2.com`; another RustFS: `https://\u003cvm\u003e.exe.xyz`; Amazon S3: leave empty\n- OFFSITE_REGION: `auto` for R2, the bucket's region for B2 and Amazon S3, `us-east-1` for RustFS\n- OFFSITE_ACCESS_KEY_ID: a key that can read and write that bucket, and nothing else\n- OFFSITE_SECRET_ACCESS_KEY: the key's secret\nAsk me for any that still say \u003cfill-this-in\u003e before you need them.\n\nThe recipe's example VM name is my-rustfs. This VM's name is the output of `hostname`: use it wherever the recipe writes my-rustfs. 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- RustFS 1.0.6 on the VM's disk, with its own root keys, started at boot.\n- The S3 API at `http://localhost:9000` on the VM and, with a VM token, at `https://my-rustfs.exe.xyz:9000/`.\n- The RustFS console at `https://my-rustfs.exe.xyz:9001/`, behind exe.dev login.\n- An `app` bucket and a key that can use only that bucket, in `~/rustfs/app.env`.\n- Nightly backups of every bucket, user, and policy to a bucket off the VM, one restored and checked.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" from top to bottom: Docker, the root keys,\nRustFS in Docker Compose, rc and the app bucket, rclone and the backup\ntimer, and the backup test. The walkthrough sections are for the owner\nafterwards: don't make the VM public, change its shared port, move data\nfrom MinIO, or run the Restore or Update instructions during setup.\nWrite the owner's OFFSITE_* values into ~/rustfs/offsite.env without\nprinting the secret. If OFFSITE_BUCKET is `none` or the owner has no\nbucket yet, skip \"Give the backups a bucket\", run the \"No bucket yet?\"\nblock instead of the one before it, and tell the owner that the backups\nstay on the VM until they add a bucket (\"Add a bucket later\"). If the bucket\nalready holds a `rustfs/` folder, stop and ask the owner: it may be\nanother VM's backup, which the nightly sync would overwrite.\nNever overwrite an existing ~/rustfs/.env or ~/rustfs/*.env file.\nDelete only the scratch bucket and the scratch restore the backup test\ncreates. Leave the VM private and do not reboot. Don't paste keys into\nthe chat; say they are in ~/rustfs/.env and ~/rustfs/app.env.\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 ssh-key generate-api-key --vm=my-rustfs --label=s3 --exp=90d\n  ssh -N -L 9000:localhost:9000 my-rustfs.exe.xyz\n",
    "prompt_url": "https://exe.dev/deploy/rustfs/prompt.txt"
  },
  "published": "2026-11-19",
  "updated": "2026-11-19",
  "verified": "2026-11-19",
  "related": [
    "s3-storage",
    "minio",
    "garage",
    "seaweedfs",
    "postgres",
    "sqlite"
  ],
  "alternatives": [
    "MinIO",
    "Amazon S3",
    "Cloudflare R2"
  ],
  "files": [
    "https://exe.dev/deploy/rustfs/backup.sh",
    "https://exe.dev/deploy/rustfs/exedev_token.py",
    "https://exe.dev/deploy/rustfs/new-app.sh"
  ]
}
