[{"_1":2,"_168":-5,"_169":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_143":144},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_134":-5,"_135":11,"_136":17,"_137":11,"_138":-5,"_139":11,"_140":-5,"_141":142},"canonicalUrl","https://hub.docker.com/r/ramosisw/mc/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","ramosisw","reponame","mc","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2019-10-07T17:05:55.619149Z","description","MinIO Client","is_private","last_updated","2019-10-10T20:56:54.144285Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",90,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# MinIO Client Quickstart Guide\n[![Slack](https://slack.min.io/slack?type=svg)](https://slack.min.io) [![Go Report Card](https://goreportcard.com/badge/minio/mc)](https://goreportcard.com/report/minio/mc) [![Docker Pulls](https://img.shields.io/docker/pulls/ramosisw/mc.svg?maxAge=604800)](https://hub.docker.com/r/ramosisw/mc/)\n\nMinIO Client (mc) provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff, find etc. It supports filesystems and Amazon S3 compatible cloud storage service (AWS Signature v2 and v4).\n\n```\nls list buckets and objects\nmb make a bucket\nrb remove a bucket\ncat display object contents\nhead display first 'n' lines of an object\npipe stream STDIN to an object\nshare generate URL for temporary access to an object\ncp copy objects\nmirror synchronize objects to a remote site\nfind search for objects\nsql run sql queries on objects\nstat stat contents of objects\ndiff list differences in object name, size, and date between buckets\nrm remove objects\nevent manage object notifications\nwatch watch for object events\npolicy manage anonymous access to objects\nadmin manage MinIO servers\nsession manage saved sessions for cp command\nconfig manage mc configuration file\nupdate check for a new software update\nversion print version info\n```\n\n## Docker Container\n### Stable\n```\ndocker pull minio/mc\ndocker run minio/mc ls play\n```\n**Note:** Above examples run `mc` against MinIO [_play_ environment](#test-your-setup) by default. To run `mc` against other S3 compatible servers, start the container this way:\n\n```\ndocker run -it --entrypoint=/bin/sh minio/mc\n```\n\nthen use the [`mc config` command](#add-a-cloud-storage-service).\n\n## Add a Cloud Storage Service\nIf you are planning to use `mc` only on POSIX compatible filesystems, you may skip this step and proceed to [everyday use](#everyday-use).\n\nTo add one or more Amazon S3 compatible hosts, please follow the instructions below. `mc` stores all its configuration information in ``~/.mc/config.json`` file.\n\n```\nmc config host add

--api --lookup \n```\n\nAlias is simply a short name to your cloud storage service. S3 end-point, access and secret keys are supplied by your cloud storage provider. API signature is an optional argument. By default, it is set to \"S3v4\".\n\nLookup is an optional argument. It is used to indicate whether dns or path style url requests are supported by the server. It accepts \"dns\", \"path\" or \"auto\" as valid values. By default, it is set to \"auto\" and SDK automatically determines the type of url lookup to use.\n\n### Example - MinIO Cloud Storage\nMinIO server displays URL, access and secret keys.\n\n```\nmc config host add minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12\n```\n\n### Example - Amazon S3 Cloud Storage\nGet your AccessKeyID and SecretAccessKey by following [AWS Credentials Guide](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html).\n\n```\nmc config host add s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12\n```\n\n**Note**: As an IAM user on Amazon S3 you need to make sure the user has full access to the buckets or set the following restricted policy for your IAM user\n\n```json\n{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Sid\": \"AllowBucketStat\",\n \"Effect\": \"Allow\",\n \"Action\": [\n \"s3:HeadBucket\"\n ],\n \"Resource\": \"*\"\n },\n {\n \"Sid\": \"AllowThisBucketOnly\",\n \"Effect\": \"Allow\",\n \"Action\": \"s3:*\",\n \"Resource\": [\n \"arn:aws:s3:::/*\",\n \"arn:aws:s3:::\"\n ]\n }\n ]\n}\n```\n\n### Example - Google Cloud Storage\nGet your AccessKeyID and SecretAccessKey by following [Google Credentials Guide](https://cloud.google.com/storage/docs/migrating?hl=en#keys)\n\n```\nmc config host add gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12\n```\n\n## Test Your Setup\n`mc` is pre-configured with https://play.min.io, aliased as \"play\". It is a hosted MinIO server for testing and development purpose. To test Amazon S3, simply replace \"play\" with \"s3\" or the alias you used at the time of setup.\n\n*Example:*\n\nList all buckets from https://play.min.io\n\n```\nmc ls play\n[2016-03-22 19:47:48 PDT] 0B my-bucketname/\n[2016-03-22 22:01:07 PDT] 0B mytestbucket/\n[2016-03-22 20:04:39 PDT] 0B mybucketname/\n[2016-01-28 17:23:11 PST] 0B newbucket/\n[2016-03-20 09:08:36 PDT] 0B s3git-test/\n```\n\nMake a bucket\n`mb` command creates a new bucket.\n\n*Example:*\n```\nmc mb play/mybucket\nBucket created successfully `play/mybucket`.\n```\n\nCopy Objects\n`cp` command copies data from one or more sources to a target.\n\n*Example:*\n```\nmc cp myobject.txt play/mybucket\nmyobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0\n```\n\n\n\n\n## Everyday Use\n\n### Shell aliases\nYou may add shell aliases to override your common Unix tools.\n\n```\nalias ls='mc ls'\nalias cp='mc cp'\nalias cat='mc cat'\nalias mkdir='mc mb'\nalias pipe='mc pipe'\nalias find='mc find'\n```\n\n### Shell autocompletion\nIn case you are using bash, zsh or fish. Shell completion is embedded by default in `mc`, to install auto-completion use `mc --autocompletion`. Restart the shell, mc will auto-complete commands as shown below.\n\n```\nmc \nadmin config diff find ls mirror policy session sql update watch\ncat cp event head mb pipe rm share stat version\n```\n\n## Explore Further\n- [MinIO Client Complete Guide](https://docs.min.io/docs/minio-client-complete-guide)\n- [MinIO Quickstart Guide](https://docs.min.io/docs/minio-quickstart-guide)\n- [The MinIO documentation website](https://docs.min.io)\n\n## Contribute to MinIO Project\nPlease follow MinIO [Contributor's Guide](https://github.com/minio/mc/blob/master/CONTRIBUTING.md)\n\n## License\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fminio%2Fmc.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fminio%2Fmc?ref=badge_large)","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",53426952,"orgData","recentTags",[87,124],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":99,"_118":119,"_120":105,"_121":114,"_122":62,"_123":17},"content_type","creator",3184661,"full_size",8432088,"id",71625682,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","arm","digest","sha256:2bc057d7ead425f41a178ac5ac881f156077b4b17b1cfc7890efd8b60ccfee75","features","","last_pulled","2026-09-15T10:08:12.703053169Z","last_pushed","2019-10-10T20:56:54Z","os","linux","os_features","os_version","size","variant","2019-10-10T20:56:53.574942Z","last_updater","last_updater_username","media_type","repository",7818981,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_88":40,"_89":90,"_91":125,"_93":126,"_95":127,"_46":133,"_115":90,"_116":29,"_117":52,"_53":129,"_118":119,"_120":131,"_121":133,"_122":62,"_123":17},9251913,71967932,[128],{"_98":129,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":125,"_59":62,"_113":-5},"amd64","sha256:4854cb924c48beb7bb5cd5c87d087d5fe86f1a5a2dcc090598cc7ac28a28a155","2026-09-04T04:08:59.97478562Z","2019-10-09T22:07:01Z","2019-10-09T22:07:00.147926Z","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":145,"_152":153,"_141":166,"_167":11},{"_36":146,"_38":147,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":148,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":149,"_75":11,"_76":151,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":150},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_154":155,"_156":-5,"_157":-5,"_158":159},"count",2,"next","previous","results",[160,163],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":161,"_46":114,"_115":90,"_116":29,"_117":52,"_53":99,"_118":119,"_120":105,"_121":114,"_122":62,"_123":17},[162],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},{"_88":40,"_89":90,"_91":125,"_93":126,"_95":164,"_46":133,"_115":90,"_116":29,"_117":52,"_53":129,"_118":119,"_120":131,"_121":133,"_122":62,"_123":17},[165],{"_98":129,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":125,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

ramosisw/mc

Tags for ramosisw/mc