s3gw
s3gw is a lightweight, S3-compatible object store, focused on small deployments.
The s3gw service can be deployed in a myriad of scenarios, provided some form of storage is attached. This includes cloud native environments, such as Kubernetes, and can be backed by any PVC.
Quickstart
Helm Chart
An easy way to deploy the S3 Gateway on your Kubernetes cluster is via a Helm chart: ```shell helm repo add s3gw https://s3gw-tech.github.io/s3gw-charts/ helm install s3gw s3gw/s3gw --namespace s3gw-system --create-namespace \ --set publicDomain=YOUR_DOMAIN_NAME \ --set ui.publicDomain=YOUR_DOMAIN_NAME ``` Helm is the preferred deployment method, and will automatically use your cluster's default storage class for the backing store. If you have Longhorn installed already, s3gw will thus use a Longhorn PV. The above assumes cert-manager and traefik are available, but these and other settings can be overridden via values.yaml. Check out the [documentation][helm-docs] for details and configuration options.Podman
```shell podman run --replace --name=s3gw -it -p 7480:7480 quay.io/s3gw/s3gw:latest ``` Podman deployments will use ephemeral storage inside the container by default, which should only be used for testing purposes. To use a directory on the host system for storage, pass `-v/host-path:/data`.Docker
```shell docker pull quay.io/s3gw/s3gw:latest ``` In order to run the Docker container: ```shell docker run -p 7480:7480 quay.io/s3gw/s3gw:latest ``` Docker deployments will use ephemeral storage inside the container by default, which should only be used for testing purposes. To use a directory on the host system for storage, pass `-v /host-path:/data`.Documentation
You can access our documentation here.
License
Licensed under the Apache License, Version 2.0 (the "License"); you may not use licensed files except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
or the LICENSE file in this repository.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.