Home / Vestra

All your buckets, in one friendly app.

Vestra lets you browse, preview, upload and move files across your cloud storage, from a desktop app or your own server. It's open source under Apache 2.0, and your credentials stay on your machine.

Download for Mac Read the code on GitHub

Free · Apple silicon · macOS 12 or later · about 135 MB · Release notes · Windows, Linux & Docker

Works with

And here's the real thing.

The demo above is a sketch. These are screenshots and a recording of the actual app, browsing two public Google Cloud buckets.

The bucket console you'll actually enjoy opening.

Cloud consoles are built for administrators. Vestra is built for the people who work in their buckets every day.

Split view

Two connections side by side. Drag a file across to copy it between clouds.

Preview anything

Images, PDF, video, audio, Markdown, JSON, CSV, Excel, Word and code, without downloading.

Cross-cloud transfer
Copy single files or whole selections between any two providers as streamed background jobs.
Drag-and-drop upload
Drop files or entire folders. Structure preserved, live per-file progress.
Expiring share links
Signed URLs that expire in 15 minutes, 1 hour, 24 hours or 7 days.
Zip & bulk actions
Multi-select to download, zip, delete or transfer in one go.
Keyboard-first
j/k to move, Space to preview, / to search, ? for every shortcut.
Encrypted credentials
AES-encrypted at rest. Credentials never reach the browser after you save them.
CLI command copy
One click for the matching aws s3, gsutil, azcopy, ossutil or obsutil command.
Metadata editor
Edit Content-Type, Cache-Control and custom metadata in place.

On your desktop

A native app for macOS, Windows and Linux.

No login, no server. Vestra runs its backend on a random 127.0.0.1 port that only its own window can reach, and keeps connections encrypted in your app data folder.

On your server

One container that keeps every bucket a browser tab away.

Run it on any server with Docker. A single owner account with optional two-factor authentication guards the interface; SQLite keeps everything in one volume.

Install it, then add your first bucket.

1

Run Vestra

shell
 curl -LO https://github.com/PandhuWibowo/anveesa-vestra-releases/releases/latest/download/Anveesa-Vestra-arm64.dmg
open Anveesa-Vestra-arm64.dmg

For Macs with Apple silicon. Open the .dmg and drag Anveesa Vestra to Applications. The first time, right-click it and choose Open: the app is signed by us rather than through Apple, so macOS asks once.

2

Connect a bucket

Bucket Bucket name, without gs:// service-account.json
 {
"type" : "service_account" ,
"project_id" : "my-project" ,
"private_key" : "-----BEGIN PRIVATE KEY-----\n…" ,
"client_email" : "vestra@my-project.iam.gserviceaccount.com"
}

Choose the service-account key file you downloaded, or paste it. Storage Object Viewer is enough to browse; Storage Object Admin to upload, rename and delete. Public buckets need no credentials. Press N → pick the provider → fill in the fields → Test connection → Add storage.

Reference, for when you need the details.

On this page

Report an issue

Using Vestra

Click a storage in the sidebar to open it. Everything else is one click, or one key, away.

Browse & organise

  • Breadcrumb navigation with infinite scroll, 200 objects per page
  • Sort by name, size or modified; instant filter with /
  • Table or thumbnail grid, remembered per browser
  • Create folders, rename or move, recursive folder delete
  • Pin favorite folders; export and import all connections as JSON

Upload & download

  • Drop files anywhere, or upload a whole folder with its structure
  • Per-file progress bars with live percentage
  • Signed one-click downloads; zip a folder or a selection
  • Desktop app uses native save dialogs

Preview

  • Fullscreen with F; image zoom 10–500% with Ctrl + scroll
  • Text and code up to 5 MB, streamed in 500-line chunks
  • Line numbers and word-wrap toggles for code
  • CSV, TSV and Excel as sortable tables (2,000 rows)

Move & share

  • Copy a file to any other connection, with an optional prefix
  • Bulk transfers run as background jobs, three at a time
  • Shareable links expiring in 15 min, 1 h, 24 h or 7 days
  • Copy gs://, s3:// or az:// paths and matching CLI commands

How a transfer moves

Transfers stream through Vestra instead of loading whole files into memory, so large files work. Bulk transfers wait in a background queue that runs three at a time.

Security

Vestra is a personal tool with one owner. It is designed so your credentials stay where you put them.

Encrypted at rest

Credentials are AES-encrypted in SQLite. APIs reference them by connection ID and never return them.

Owner login + 2FA

One owner account with bcrypt-hashed password and optional TOTP from any authenticator app.

Rate limited

20 req/s per IP across the API, and 5 req/min on login to stop brute-force attempts.

Desktop isolation

The desktop backend binds to 127.0.0.1 and rejects any request without the per-launch token.

How the desktop app stays private

The desktop backend listens on 127.0.0.1 on a random port and rejects any request without the token that only the Vestra window carries.

Set JWT_SECRET and ENCRYPTION_KEY to strong, unique values before exposing Vestra beyond your machine. Forgot your password? Stop the server and delete data.db to start fresh.

Deploy & backup

The Docker image bundles the Go API and the web UI behind nginx. Everything stateful lives in /data.

Back up the volume

 docker run --rm -v anveesa-data:/data -v $(pwd):/backup alpine \
tar czf /backup/vestra-backup.tar.gz -C /data .

Run as a Linux service

Build with make build, copy bin/server to /opt/anveesa-vestra, then:

/etc/systemd/system/anveesa-vestra.service
 [Service]
ExecStart=/opt/anveesa-vestra/bin/server
Environment=JWT_SECRET=your-secret
Environment=ENCRYPTION_KEY=your-key
Environment=DB_PATH=/opt/anveesa-vestra/data.db
Restart=on-failure

Image tags: latest tracks main, or pin a release such as v1.2.3.

Configuration

Everything is an environment variable. Sensible defaults mean you only need the first two.

VariableDefaultPurpose
JWT_SECRETchange-me-in-productionSigns login tokens. Always set in production.
ENCRYPTION_KEYauto-generatedAES key for stored credentials. Set it so data survives a rebuild.
AUTH_ENABLEDtrueSet false only behind a trusted network or VPN.
JWT_EXPIRY24hSession lifetime, e.g. 12h or 7d.
PORT8080API listen port (the Docker image serves on 80).
DB_PATHdata.dbSQLite file. /data/… inside Docker.
CORS_ORIGIN*Restrict to your domain in production.
TRUST_PROXYfalseTrust X-Forwarded-For when behind a reverse proxy.

Keyboard shortcuts

Press ? anywhere in the app to see these.

J ↓ Next row K ↑ Previous row Enter Open folder or preview Space Toggle preview F Fullscreen preview D Download Delete Delete / Search this folder R Refresh ⌫ Up one level N Add storage ⌘ \ Show or hide the sidebar ? All shortcuts

REST API

Everything the UI does is available over HTTP: connections, browsing, uploads, transfers and jobs.

API reference Endpoints for all six providers, authentication, transfers and jobs, with request and response examples. /api/auth /api/gcp /api/aws /api/azure /api/jobs

常见问题

What is Anveesa Vestra?

Vestra is an open-source cloud storage manager. You browse, preview, upload and move files across your buckets from one app, on your desktop or on your own server. It is Apache 2.0 licensed.

Which storage providers does Vestra support?

Google Cloud Storage, Amazon S3, Cloudflare R2, MinIO, Azure Blob Storage, Alibaba OSS, Huawei OBS and Google Drive, plus S3-compatible clouds such as Wasabi, DigitalOcean Spaces and Backblaze B2.

Is there a desktop app?

Yes, for macOS, Windows and Linux. You can also run it on a server with Docker, using the pandhu612/anveesa-vestra image.

Where are my cloud credentials stored?

On your own machine or server, encrypted with AES. They are never sent to Anveesa.

Can I move files between two clouds?

Yes. Open two buckets side by side in split view and drag files from one to the other, even when they are on different providers.

Found a bug, or missing a provider?

Vestra is open source. Open an issue and tell us what you need.

Open an issue on GitHubBack to install steps