> ## Documentation Index
> Fetch the complete documentation index at: https://herd.laravel.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# RustFS

# Set up RustFS

RustFS is an open-source, S3-compatible object storage server. It's a drop-in alternative to MinIO and works with the same AWS S3 APIs you use in production. You can set up RustFS as a Herd service and use its built-in dashboard to create buckets.

<Frame>
  <img alt="Screenshot of RustFS settings" src="https://mintcdn.com/herd/VxtUkRdjBm4glB3q/images/docs/windows/settings_services_rustfs_wizard.png?fit=max&auto=format&n=VxtUkRdjBm4glB3q&q=85&s=9c9c43668c91acd6b1087f434fe28985" width="2505" height="1686" data-path="images/docs/windows/settings_services_rustfs_wizard.png" />
</Frame>

## Configuration

Before connecting your application to RustFS, create a bucket using the dashboard. Access the dashboard or view service logs via the Herd service configuration.

<Frame>
  <img alt="Screenshot of the RustFS configuration" src="https://mintcdn.com/herd/VxtUkRdjBm4glB3q/images/docs/windows/settings_services_rustfs.png?fit=max&auto=format&n=VxtUkRdjBm4glB3q&q=85&s=bebb60a43f0a974326a13d610305c784" width="2515" height="1690" data-path="images/docs/windows/settings_services_rustfs.png" />
</Frame>

The console dashboard runs on port+1 — if your RustFS server runs on port 9000, the dashboard is available on port 9001.

## Dashboard

Access the RustFS dashboard via `http://localhost:CONSOLE_PORT` or by using the dashboard button in the services list. Log in with the default credentials (`herd` / `secretkey`) to create your first bucket.

<Frame>
  <img alt="Screenshot of the RustFS dashboard" src="https://mintcdn.com/herd/VxtUkRdjBm4glB3q/images/docs/windows/setup-rustfs-dashboard.png?fit=max&auto=format&n=VxtUkRdjBm4glB3q&q=85&s=7a44c2081353189b1e1c19ecf3d9a2b9" width="2294" height="1590" data-path="images/docs/windows/setup-rustfs-dashboard.png" />
</Frame>

## Environment Variables

After configuring the service name, port, and autostart options, start the service, log into the dashboard, and create a bucket.

Then update your `.env` file to connect your Laravel application to RustFS:

```env theme={null}
AWS_BUCKET=herd-bucket # Your bucket name
AWS_ACCESS_KEY_ID=herd
AWS_SECRET_ACCESS_KEY=secretkey
AWS_USE_PATH_STYLE_ENDPOINT=true
AWS_DEFAULT_REGION=us-east-1
AWS_URL=http://localhost:9000/herd-bucket
AWS_ENDPOINT=http://localhost:9000
```

### HTTPS

If you enable "Serve over HTTPS" in the service configuration, your RustFS instance will be available via a `.herd.test` domain with a trusted SSL certificate. Update your `.env` accordingly:

```env theme={null}
AWS_BUCKET=herd-bucket
AWS_ACCESS_KEY_ID=herd
AWS_SECRET_ACCESS_KEY=secretkey
AWS_USE_PATH_STYLE_ENDPOINT=true
AWS_DEFAULT_REGION=us-east-1
AWS_URL=https://rustfs.herd.test/herd-bucket
AWS_ENDPOINT=https://rustfs.herd.test
```

Replace `rustfs` in the URL with the name of your RustFS service (as shown in Herd).

You can find additional information about configuring S3-compatible storage with Laravel in the [Laravel documentation](https://laravel.com/docs/11.x/filesystem#amazon-s3-compatible-filesystems).