Note
THIS REPOSITORY IS NO LONGER MAINTAINED.
Alternatives:
- AIStor Free — Full-featured, standalone edition for community use (free license)
- AIStor Enterprise — Distributed edition with commercial support
BuckIt is a high-performance, S3-compatible object storage solution released under the GNU AGPL v3.0 license. Designed for speed and scalability, it powers AI/ML, analytics, and data-intensive workloads with industry-leading performance.
- S3 API Compatible – Seamless integration with existing S3 tools
- Built for AI & Analytics – Optimized for large-scale data pipelines
- High Performance – Ideal for demanding storage workloads.
This README provides instructions for building BuckIt from source and deploying onto baremetal hardware. Use the BuckIt Documentation project to build and host a local copy of the documentation.
We designed BuckIt as Open Source software for the Open Source software community. We encourage the community to remix, redesign, and reshare BuckIt under the terms of the AGPLv3 license.
All usage of BuckIt in your application stack requires validation against AGPLv3 obligations, which include but are not limited to the release of modified code to the community from which you have benefited. Any commercial/proprietary usage of the AGPLv3 software, including repackaging or reselling services/features, is done at your own risk.
The AGPLv3 provides no obligation by any party to support, maintain, or warranty the original or any modified work. All support is provided on a best-effort basis through Github and our Slack channel, and any member of the community is welcome to contribute and assist others in their usage of the software.
BuckIt AIStor includes enterprise-grade support and licensing for workloads which require commercial or proprietary usage and production-level SLA/SLO-backed support. For more information, reach out for a quote.
Important: The BuckIt community edition is now distributed as source code only. We will no longer provide pre-compiled binary releases for the community version.
To use BuckIt community edition, you have two options:
- Install from source using
go install github.com/minio/minio@latest(recommended) - Build a Docker image from the provided Dockerfile
See the sections below for detailed instructions on each method.
Historical pre-compiled binary releases remain available for reference but are no longer maintained:
- GitHub Releases: https://github.com/minio/minio/releases
- Direct downloads: https://dl.min.io/server/minio/release/
These legacy binaries will not receive updates. We strongly recommend using source builds for access to the latest features, bug fixes, and security updates.
Use the following commands to compile and run a standalone BuckIt server from source. If you do not have a working Golang environment, please follow How to install Golang. Minimum version required is go1.24
go install github.com/minio/minio@latestYou can alternatively run go build and use the GOOS and GOARCH environment variables to control the OS and architecture target.
For example:
env GOOS=linux GOARCH=arm64 go build
Start BuckIt by running minio server PATH where PATH is any empty folder on your local filesystem.
The BuckIt deployment starts using default root credentials minioadmin:minioadmin.
You can test the deployment using the BuckIt Console, an embedded web-based object browser built into BuckIt Server.
Point a web browser running on the host machine to http://127.0.0.1:9000 and log in with the root credentials.
You can use the Browser to create buckets, upload objects, and browse the contents of the BuckIt server.
You can also connect using any S3-compatible tool, such as the BuckIt Client mc commandline tool:
mc alias set local http://localhost:9000 minioadmin minioadmin
mc admin info localSee Test using BuckIt Client mc for more information on using the mc commandline tool.
For application developers, see https://docs.min.io/enterprise/aistor-object-store/developers/sdk/ to view BuckIt SDKs for supported languages.
Note
Production environments using compiled-from-source BuckIt binaries do so at their own risk. The AGPLv3 license provides no warranties nor liabilities for any such usage.
You can use the docker build . command to build a Docker image on your local host machine.
You must first build BuckIt and ensure the minio binary exists in the project root.
The following command builds the Docker image using the default Dockerfile in the root project directory with the repository and image tag myminio:minio
docker build -t myminio:minio .Use docker image ls to confirm the image exists in your local repository.
You can run the server using standard Docker invocation:
docker run -p 9000:9000 -p 9001:9001 myminio:minio server /tmp/minio --console-address :9001Complete documentation for building Docker containers, managing custom images, or loading images into orchestration platforms is out of scope for this documentation.
You can modify the Dockerfile and dockerscripts/docker-entrypoint.sh as-needed to reflect your specific image requirements.
See the BuckIt Container documentation for more guidance on running BuckIt within a Container image.
There are two paths for installing BuckIt onto Kubernetes infrastructure:
- Use the BuckIt Operator
- Use the community-maintained Helm charts
See the BuckIt Documentation for guidance on deploying using the Operator. The Community Helm chart has instructions in the folder-level README.
BuckIt Server comes with an embedded web based object browser. Point your web browser to http://127.0.0.1:9000 to ensure your server has started successfully.
Note
BuckIt runs console on random port by default, if you wish to choose a specific port use --console-address to pick a specific interface and port.
mc provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff etc. It supports filesystems and Amazon S3 compatible cloud storage services.
The following commands set a local alias, validate the server information, create a bucket, copy data to that bucket, and list the contents of the bucket.
mc alias set local http://localhost:9000 minioadmin minioadmin
mc admin info
mc mb data
mc cp ~/Downloads/mydata data/
mc ls data/Follow the BuckIt Client Quickstart Guide for further instructions.
- The BuckIt documentation website
- BuckIt Erasure Code Overview
- Use
mcwith BuckIt Server - Use
minio-goSDK with BuckIt Server
Please follow BuckIt Contributor's Guide for guidance on making new contributions to the repository.
- BuckIt source is licensed under the GNU AGPLv3.
- BuckIt documentation is licensed under CC BY 4.0.
- License Compliance