Ubuntu 24.04 లో MinIO సెటప్ చేయడం ఎలా?
Ubuntu 24.04 VPSలో MinIOను ఇన్స్టాల్ చేసే విధానం ఇక్కడ ఉంది. ఇందులో source build, systemd unit కాన్ఫిగరేషన్, mc కమాండ్స్ మరియు restic బ్యాకప్ సెటప్ గురించి పూర్తి వివరాలు ఉన్నాయి.
MinIO అందించే self-hosted object storage ప్రయోజనాలు
MinIO అనేది Amazon S3 APIతో పనిచేసే self-hosted object storage. మీ స్వంత serverను సూచించేలా restic లేదా S3 SDKలో ఒక endpoint setting మార్చితే, రోజువారీ object reads, writes, listings మరియు presigned links కోసం అంతే సరిపోతుంది. అయితే compatible అంటే identical అని కాదు. ఉదాహరణకు, MinIO Amazon object ACLsను అమలు చేయదు. కాబట్టి ACL ప్రవర్తనపై ఆధారపడే applicationకు కొత్త endpoint కంటే ఎక్కువ మార్పులు అవసరం. ఈ guide Ubuntu 24.04లో ఒకే nodeను నిర్మిస్తుంది: ధృవీకరించిన source నుంచి compile చేసిన binary, ప్రత్యేక system user, root credentialsను unit fileలో ఉంచకుండా నిర్వహించే systemd unit, అలాగే restic backupలను నిల్వ చేసే bucket.
S3 (simple storage service) అనేది filesystem కాదు; అది HTTP API. మీరు ఒక bucketలోని key కింద objectను PUT చేసి, తరువాత దాన్ని GET చేస్తారు. సాధారణ bucketలో partial write లేదా rename ఉండదు. Amazon యొక్క S3 Express One Zone directory buckets దీనికి మినహాయింపు. వాటికి స్వంత append మరియు rename calls ఉన్నాయి. అయితే అది ఒక storage class మాత్రమే. ఈ guideలోని ఏ అంశమూ దానిపై ఆధారపడదు. Backup tools ప్రామాణిక modelను ఇష్టపడతాయి. ఎందుకంటే object పూర్తిగా చేరింది లేదా అసలు చేరలేదు.
ఒక node మీ data యొక్క ఒక copyని మాత్రమే ఉంచుతుంది. మీరు చేస్తున్న trade-off ఇదే. VPS ధరకు మీరు నియంత్రించే S3 endpointను పొందుతారు. అదే సమయంలో cloud provider నిర్వహించిన ప్రతి పనికీ మీరు బాధ్యత వహించాలి. విఫలమైన diskను మార్చడం నుంచి server softwareను patch చేయడం వరకు అన్నీ ఇందులో ఉంటాయి. ఈ trade-off ఎప్పుడు సముచితమో చివరికి సమీపంలోని sectionలో స్పష్టంగా వివరిస్తుంది.
MinIO community edition స్థితి: October 2026
దీనిపై ఆధారపడి నిర్మాణం ప్రారంభించే ముందు ఈ భాగాన్ని చదవండి, ఎందుకంటే ఇది ఇటీవల మారింది. May 2025లో MinIO community editionలోని administration features ను web console నుంచి తొలగించింది. Browserలో ఇప్పుడు object browser మాత్రమే మిగిలి ఉంది. అందువల్ల buckets మరియు access keys ను బదులుగా mc command line client తో నిర్వహించాలి.
2025 చివరి కాలంలో MinIO pre-compiled community binaries ను ప్రచురించడం ఆపివేసింది. Community edition source code రూపంలో మాత్రమే పంపిణీ అవుతుందని project README చెబుతోంది. April 2026 నుంచి minio/minio repository ను THIS REPOSITORY IS NO LONGER MAINTAINED notice కింద archive చేశారు. పాత download server కూడా community files ను అందించడం ఆపివేసింది. 20 October 2026న తనిఖీ చేసినప్పుడు, ఈ guide ఇంతకుముందు download చేయడానికి ఉపయోగించిన ప్రతి dl.min.io path — server binary, client binary మరియు వాటి checksum files — 410 Gone కు సమాధానం ఇస్తోంది. ఇది outage కాదు; ఉద్దేశపూర్వకంగా తొలగించారు. AIStor CLI reference ఇప్పుడు /aistor/mc/release/ కింద ఉన్న AIStor Client కు సూచిస్తోంది. అది commercial line కు చెందినది. min.io లోని download page ఇప్పుడు AIStor Server, AIStor Client, AIStor SDK మరియు కొన్ని AIStor add-ons ను మాత్రమే చూపిస్తోంది. అదనంగా రెండు నెలల AIStor trial ను ప్రచారం చేస్తోంది. Pricing page లో standalone deployments నడిపే developers, researchers మరియు చిన్న organisations కోసం ఉచిత AIStor tier ఇప్పటికీ ఉంది.
Source code ఇంకా అందుబాటులో ఉంది. అది చివరి binary కంటే కొత్తది కూడా. చివరి community release RELEASE.2025-10-15T17-29-55Z. ఇది 16 October 2025న security release గా ప్రచురించబడింది. Service accounts మరియు STSలో session policy bypass ద్వారా జరిగే privilege escalation ను ఇది సరిచేస్తుంది. Release notes ప్రకారం users అందరూ వెంటనే upgrade చేయాలి. చివరి pre-compiled binary September 2025 build. అందువల్ల దానికి ఆ fix ఎప్పుడూ అందలేదు. ఈ guide October release ను compile చేస్తుంది. Repository archive చేసినందున, community edition కు లభించే చివరి fix కూడా ఇదే.
ఈ ఒక్క విషయం ఈ guideలోని మిగతా భాగాన్ని నిర్ణయిస్తుంది. అందుకే ఇక్కడ MinIO 127.0.0.1 పై listen చేస్తుంది. మీరు నియంత్రించే proxy ద్వారా మాత్రమే internet కు చేరుతుంది.
MinIO binaryని install చేసి downloadను ధృవీకరించండి
MinIO Goలో రాయబడింది. Vendor README దీన్ని ఒకే go install commandతో build చేస్తుంది. దీనికి Go 1.24 లేదా అంతకంటే కొత్త version అవసరం. ముందుగా అధికారిక tarball నుంచి Goను install చేయండి. 11 November 2026న go.dev/dlలో ప్రస్తుత stable release go1.27.4. ఇది 10 November 2026న విడుదలైంది. ఇందులో cgo, Go command, compiler, linker మరియు net/http packageకు security fixes ఉన్నాయి. దిగువ hash ఆ పేజీలోని linux-amd64 archive కోసం ప్రచురించినదే. మీరు మరింత కొత్త Go versionను ఎంచుకుంటే, అదే పేజీ నుంచి దాని hashను తీసుకోండి. -f flag, HTTP error వచ్చినప్పుడు curl విఫలమయ్యేలా చేస్తుంది. Error pageను మీరు ఇచ్చిన పేరుతో save చేయదు. లేకపోతే 404 pageను archiveగా unpack చేసి, అది archive ఎందుకు కాదో ఆశ్చర్యపడే పరిస్థితి వస్తుంది.
cd /tmp
GOVER=go1.27.4
curl -fsSL "https://go.dev/dl/$GOVER.linux-amd64.tar.gz" -o go.tar.gzరెండు hashesను పోల్చండి. Hashలను మాత్రమే పోల్చండి.
published=7226736c2339719cda28fbf3a54d71aa63bcefe376e98cef00034268dab24840
downloaded=$(sha256sum go.tar.gz | awk '{print $1}')
[ "$published" = "$downloaded" ] && echo "checksum ok"ఈ check ఏమి నిరూపిస్తుందో స్పష్టంగా తెలుసుకోండి. రెండు hashes సరిపోతే download పూర్తిగా జరిగిందని, మార్గమధ్యంలో అది దెబ్బతినలేదని లేదా మార్చబడలేదని నిరూపిస్తుంది. Vendor నమ్మదగినవాడని ఇది నిరూపించదు. అది వేరే సమస్య. ఏ sha256sum command కూడా దాన్ని పరిష్కరించదు.
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go.tar.gz
export PATH=$PATH:/usr/local/go/bin
go versionఇప్పుడు మీ సాధారణ userగా తుది community releaseను build చేయండి. go install download చేసే ప్రతి moduleను, MinIO స్వంత sourceతో సహా, Go public checksum database అయిన sum.golang.orgతో ధృవీకరిస్తుంది. అందువల్ల tampered లేదా మార్చబడిన module కనిపిస్తే, binaryను తయారు చేయకుండా security errorతో build ఆగిపోతుంది.
go install github.com/minio/minio@RELEASE.2025-10-15T17-29-55Z
sudo install -o root -g root -m 755 ~/go/bin/minio /usr/local/bin/minio
minio --version
go version -m /usr/local/bin/minio | head -n 3Release name ఉండే స్థానంలో minio --version, DEVELOPMENT.GOGETను print చేస్తుంది. కారణం go install vendor తన binariesపై ముద్రించడానికి ఉపయోగించిన build flagsను వర్తింపజేయదు. ప్రతి binaryలో Go embed చేసే module informationను go version -m చదువుతుంది. దాని mod github.com/minio/minio line మీరు build చేసిన commit పేరును చూపిస్తుంది. ఇక్కడ Permission denied కనిపిస్తే mode తప్పుగా ఉంది. command not found అంటే /usr/local/bin మీ PATHలో లేదు. Compile కోసం VPSలో memory సరిపోకపోతే, అదే architecture ఉన్న మరో Linux machineపై అదే go installను run చేసి, binaryను అక్కడి నుంచి copy చేయండి.
సిస్టమ్ వినియోగదారుని మరియు డేటా డైరెక్టరీని సృష్టించండి
MinIO నెట్వర్క్ నుంచి అప్లోడ్లను స్వీకరిస్తుంది. అందువల్ల దీన్ని rootగా అమలు చేయకూడదు. home directory మరియు login shell లేని accountను దీనికి కేటాయించండి.
sudo groupadd -r minio-user
sudo useradd -M -r -g minio-user -s /usr/sbin/nologin minio-user
sudo mkdir -p /var/lib/minio/data
sudo chown -R minio-user:minio-user /var/lib/minio
sudo chmod 750 /var/lib/minio-r 1000 కంటే తక్కువ UIDతో system accountను సృష్టిస్తుంది. దీనివల్ల అది వ్యక్తుల కోసం ఉపయోగించే పరిధికి బయట ఉంటుంది. -M home directoryని దాటవేస్తుంది. ఎందుకంటే ఎప్పుడూ login చేయని accountకు home directoryలో ఉంచాల్సినది ఏమీ ఉండదు. ఫలితాన్ని id minio-userతో తనిఖీ చేయండి. అలాగే stat -c '%U %a' /var/lib/minioతోనూ తనిఖీ చేయండి. అది minio-user 750ని ప్రింట్ చేయాలి.
డేటా డైరెక్టరీని ఆ వినియోగదారు రాయగలగాలి. చదవడం మాత్రమే సాధ్యమైతే సరిపోదు. మొదటి ప్రారంభ సమయంలో MinIO తన configurationను ఉంచడానికి volumeలో .minio.sys directoryని సృష్టిస్తుంది. అందువల్ల root యాజమాన్యంలోని directory ఉంటే, startup సమయంలో MinIO నిష్క్రమిస్తుంది. సందేశం permission deniedతో ముగుస్తుంది. ఈ విధానంలో మీరు అమలు చేసే ప్రతి serviceకు ఇదే నియమం వర్తిస్తుంది. VPSలో కనిష్ఠ-అధికార service వినియోగదారులు దీన్ని సమగ్రంగా వివరిస్తుంది.
root ఆధారాలను environment ఫైల్లో ఉంచండి
root ఆధారాలతో ప్రతి bucketను తెరవవచ్చు. అందువల్ల అవి అందరికీ చదవగలిగే unit fileలో ఉండకూడదు. ముందుగా సరైన modeతో ఫైల్ను సృష్టించండి. తర్వాత అందులో విషయాన్ని రాయండి. ఇలా చేస్తే password ఒక్క క్షణం కూడా చదవగలిగే ఫైల్లో ఉండదు.
sudo install -o root -g root -m 600 /dev/null /etc/default/minio
printf 'MINIO_ROOT_USER=minio-root\nMINIO_ROOT_PASSWORD=%s\nMINIO_VOLUMES="/var/lib/minio/data"\nMINIO_OPTS="--address 127.0.0.1:9000 --console-address 127.0.0.1:9001"\n' "$(openssl rand -base64 24)" | sudo tee /etc/default/minio > /dev/null
sudo sed -n 's/^MINIO_ROOT_PASSWORD=//p' /etc/default/miniotee ఇప్పటికే ఉన్న ఫైల్ను మళ్లీ సృష్టించకుండా truncate చేస్తుంది. అందువల్ల mode 600గా, owner rootగా అలాగే ఉంటాయి. ఇది ఉద్దేశపూర్వకమే. privilegesను User=కు తగ్గించే ముందు systemd, EnvironmentFileను rootగా చదువుతుంది. కాబట్టి service accountకు తన ఆధారాలను తానే చదవాల్సిన అవసరం ఉండదు. service నడుస్తున్న తర్వాత, sudo -u minio-user cat /etc/default/minioతో దీనిని నిర్ధారించండి. ఆ command తప్పనిసరిగా Permission deniedను ప్రింట్ చేయాలి.
MinIOను ప్రారంభించే ముందు దాని రెండు ప్రవర్తనలను తెలుసుకోవాలి. దాని environmentలో MINIO_ROOT_USER మరియు MINIO_ROOT_PASSWORD ఏవీ లేకపోయినా, MinIO ప్రారంభించడాన్ని నిరాకరించదు. ఇది documentationలో పేర్కొన్న default credentials minioadmin:minioadminతో ప్రారంభమవుతుంది. ఏ scanner అయినా ముందుగా ప్రయత్నించే మొదటి జత ఇదే. అలా పనిచేస్తున్నప్పటికీ ఇది పూర్తిగా ఆరోగ్యంగా ఉన్నట్లు కనిపిస్తుంది. అయితే 8 characters కంటే తక్కువ passwordను ఇది తిరస్కరిస్తుంది. credentials చెల్లవని errorతో MinIO startup సమయంలోనే exit అవుతుంది. access keyకి కనీసం 3 characters, secret keyకి కనీసం 8 characters అవసరం.
MINIO_VOLUMES data path. MINIO_OPTS flagsను కలిగి ఉంటుంది. 127.0.0.1కు bind చేయడం వల్ల ఈ VPS వెలుపల ఏదీ ఇంకా S3 APIను చేరుకోలేరు. ఇది సరైన default. తర్వాత certificate కలిగి ఉన్న proxy ద్వారా మాత్రమే దీన్ని ఉద్దేశపూర్వకంగా తెరవండి.
systemd unit రాయండి
/etc/systemd/system/minio.service ను సృష్టించండి:
[Unit]
Description=MinIO object storage
Documentation=https://github.com/minio/minio
Wants=network-online.target
After=network-online.target
[Service]
User=minio-user
Group=minio-user
EnvironmentFile=/etc/default/minio
ExecStart=/usr/local/bin/minio server $MINIO_VOLUMES $MINIO_OPTS
Restart=always
RestartSec=5
NoNewPrivileges=true
[Install]
WantedBy=multi-user.targetEnvironmentFile పై ప్రారంభంలో - లేదు. ఇది టైపింగ్ పొరపాటు కాదు, ఉద్దేశపూర్వక నిర్ణయం. dash ఉంటే, file కనిపించకపోయినా systemd దాన్ని పట్టించుకోకుండా MinIO ను ప్రారంభిస్తుంది. అందువల్ల file తొలగించబడినా లేదా path తప్పుగా రాసినా, minioadmin:minioadmin పై నడుస్తున్న server మీకు తెలియకుండానే అందుబాటులోకి వస్తుంది. dash లేకపోతే, MinIO ప్రారంభమయ్యే ముందే file కనిపించకపోవడం వల్ల unit విఫలమవుతుంది. అప్పుడు journalctl -u minio, Failed to load environment files: No such file or directory ను చూపిస్తుంది. నిశ్శబ్దంగా default password ను అంగీకరించే server కంటే, ప్రారంభం కావడానికి నిరాకరించే unit ను గుర్తించడం చాలా సులభం.
$MINIO_VOLUMES మరియు $MINIO_OPTS ఉద్దేశపూర్వకంగా quotes లేకుండా ఉన్నాయి. ఎందుకంటే systemd quotes లేని variables ను whitespace ఆధారంగా వేర్వేరు arguments గా విభజిస్తుంది. అందువల్ల MINIO_OPTS లోని నాలుగు పదాలు minio server కు నాలుగు arguments గా మారతాయి. ప్రారంభ సమయంలో MinIO తన soft file descriptor limit ను వారసత్వంగా వచ్చిన hard limit కు పెంచుతుంది. systemd యొక్క default విలువలు soft కు 1024, hard కు 524288. కాబట్టి LimitNOFILE=65536 సెట్ చేస్తే MinIO కోసం ప్రభావవంతమైన limit 65536 కు తగ్గుతుంది. ఈ unit ఆ override ను ఉంచదు.
sudo systemctl daemon-reload
sudo systemctl enable --now minio
systemctl is-active minio
curl -fsS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:9000/minio/health/liveis-active, active ను చూపించాలి. Health endpoint 200 తో సమాధానం ఇవ్వాలి. Server ఏ API address పై listening చేస్తుందో journalctl -u minio -n 20 --no-pager చూపిస్తుంది. Unit పదేపదే restart అవుతుంటే, ప్రతి restart కు ముందు వచ్చిన error ను journal లో చదవండి. RestartSec=5 ఉన్నందున, వరుసగా జరిగే exits పది seconds లో ఐదు starts అనే systemd default start limit ను మించవు. అందువల్ల unit retry చేస్తూనే ఉంటుంది. Start request repeated too quickly అంటే configure చేసిన start-rate limit చేరుకుంది.
మరింత isolation కోసం, [Service] section కు ProtectSystem=full మరియు ProtectHome=true ను జోడించండి. రెండింటికీ host kernel నుంచి mount namespaces అవసరం. OpenVZ లేదా LXC వంటి host kernel ను పంచుకునే container virtualisation లో ఇవి విఫలమయ్యే అవకాశం ఉంది. అప్పుడు unit status=226/NAMESPACE ను చూపిస్తుంది. ఆ రెండు lines తొలగిస్తే unit ప్రారంభమవుతుంది. ఈ unit సాధారణ unit మాత్రమే. మిగిలిన directives గురించి VPS పై systemd services మరియు timers లో వివరించబడింది.
mc ను ఇన్స్టాల్ చేసి, round trip ను నిర్ధారించండి
MinIO client పేరు mc. దీనిని apt install mc తో ఇన్స్టాల్ చేయవద్దు. ఆ package MinIOకి సంబంధం లేని file manager అయిన Midnight Commander.
పాత community మార్గమైన https://dl.min.io/client/mc/release/linux-amd64/mc, 410 Gone కు సమాధానం ఇస్తుంది. AIStor CLI reference ఇప్పుడు AIStor Client ను https://dl.min.io/aistor/mc/release/linux-amd64/mc వద్ద సూచిస్తోంది. Licensed AIStor Server deployments కోసం మాత్రమే ప్రత్యేక functionality అందిస్తుందని అది వివరిస్తుంది. Community server పై దీనిని ఉపయోగించడం గురించి ఆ reference లో ఏమీ లేదు. అందువల్ల ఈ guide community client తోనే కొనసాగుతుంది. minio/mc repository July 2026 నుంచి archived గా ఉంది. కాబట్టి అదే Go toolchain తో దాని చివరి release అయిన RELEASE.2025-08-13T08-35-41Z ను build చేయండి. ఈ download కు కూడా checksum database రక్షణ అందిస్తుంది.
go install github.com/minio/mc@RELEASE.2025-08-13T08-35-41Z
sudo install -o root -g root -m 755 ~/go/bin/mc /usr/local/bin/mcServer ను alias గా నమోదు చేసి, దాని ద్వారా ఒక object ను తరలించండి.
MINIO_PASS=$(sudo sed -n 's/^MINIO_ROOT_PASSWORD=//p' /etc/default/minio)
mc alias set local http://127.0.0.1:9000 minio-root "$MINIO_PASS"
mc mb local/backups
echo "hello object storage" > /tmp/hello.txt
mc cp /tmp/hello.txt local/backups/hello.txt
mc ls local/backups
mc cat local/backups/hello.txtmc ls దాని పరిమాణంతో పాటు hello.txt ను list చేయాలి. mc cat hello object storage ను print చేయాలి. ఈ round trip ద్వారా server సరిగ్గా పనిచేస్తోందని నిజంగా నిర్ధారించవచ్చు. ఎందుకంటే ప్రతి ఇతర client పంపే signed S3 requests నే ఇది పంపుతుంది. మరోసారి నిర్ధారించాలనుకుంటే mc admin info local server status ను print చేస్తుంది.
ఇప్పుడు, machine ఇంకా ఖాళీగా ఉన్నప్పుడే, మరో check నిర్వహించండి.
mc alias set defaultcheck http://127.0.0.1:9000 minioadmin minioadminఈ command తప్పక fail కావాలి. ఇది విజయవంతమైతే, environment file process కు చేరలేదు. మీ server default credentials తో నడుస్తోంది. మరే ఇతర ప్రక్రియ machine ను ఉపయోగించే ముందు దీనిని సరిచేయండి.
mc aliases ను ~/.mc/config.json లో plain text గా నిల్వ చేస్తుంది. అందువల్ల ఆ credentials command నడిపిన వ్యక్తి home directory లో ఉంటాయి. mc ను sudo కింద నడిపితే root credentials /root/.mc/config.json లో నిల్వ అవుతాయి. root alias ను ఒక administrator account లో మాత్రమే ఉంచండి. ప్రతి application కు దాని స్వంత key ఇవ్వండి.
ఒక presigned URLతో ఒక ఆబ్జెక్ట్ను పంపడం
Presigned URL అనేది ఒక సాధారణ HTTPS లింక్, దీనికి ఒక signature మరియు గడువు తేదీ (expiry) జతచేయబడి ఉంటాయి. ఈ లింక్ ఉన్న ఎవరైనా సరే, ఎటువంటి ఖాతా లేదా క్లయింట్ అవసరం లేకుండానే ఆ నిర్దిష్ట ఆబ్జెక్ట్ను పొందవచ్చు.
mc share download --expire 12h local/backups/hello.txtఈ అవుట్పుట్ query stringలో X-Amz-Signature మరియు X-Amz-Expiresలను కలిగి ఉంటుంది. దీని గురించి రెండు విషయాలు వినియోగదారులను ఆశ్చర్యపరుస్తాయి. మీరు ఉపయోగించిన aliasలోని endpoint నుండే ఈ లింక్ తయారవుతుంది, కాబట్టి 127.0.0.1పై ఉన్న alias ద్వారా తయారైన లింక్ను ఆ మెషీన్ మాత్రమే తెరవగలదు: మీరు ఇతరులకు పంపాలనుకునే లింక్ల కోసం మీ public hostnameపై రెండవ aliasను సృష్టించుకోండి. అలాగే, ప్రతి లింక్కు విడిగా revoke చేసే బటన్ ఉండదు. Signature గడువు ముగిసే వరకు లేదా దానిని సంతకం చేసిన key తొలగించబడే వరకు లేదా మారే వరకు అది చెల్లుబాటు అవుతుంది. root credentialsతో సంతకం చేసిన లింక్ విషయంలో, ఆ credentialsను మార్చడం (rotating) తప్ప వేరే మార్గం లేదు, కాబట్టి తక్కువ గడువు సమయాన్ని (short expiry) నిర్ణయించుకోవడమే ఆచరణాత్మక నియంత్రణ. S3 signature ఫార్మాట్ అనుమతించే గరిష్ట గడువు ఏడు రోజులు.
restic కోసం ప్రత్యేక key మరియు bucket
root credentials ప్రతి bucketను చదవగలవు మరియు తొలగించగలవు. అందువల్ల backup job వాటిని ఉపయోగించకూడదు. ఒక bucket, ఆ bucketకే పరిమితమైన policy, మరియు మరేదీ అనుమతించని userను సృష్టించండి.
mc mb local/restic
cat > /tmp/restic-rw.json <<'EOF'
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket", "s3:GetBucketLocation"],
"Resource": ["arn:aws:s3:::restic"]
},
{
"Effect": "Allow",
"Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
"Resource": ["arn:aws:s3:::restic/*"]
}
]
}
EOF
RESTIC_KEY=$(openssl rand -base64 24)
mc admin policy create local restic-rw /tmp/restic-rw.json
mc admin user add local restic-backup "$RESTIC_KEY"
mc admin policy attach local restic-rw --user restic-backupMinIOలో అంతర్నిర్మిత readwrite policy ఉంది. దాన్ని ఉపయోగిస్తే ఒక command తక్కువయ్యేది. అయితే అది serverలోని ప్రతి bucketకు పూర్తి ప్రాప్యతను ఇస్తుంది. పై policyలో bucket పేరు ఉద్దేశపూర్వకంగా రెండుసార్లు ఉంది: bucketను list చేయడానికి arn:aws:s3:::resticగా ఒకసారి, అందులోని objects కోసం arn:aws:s3:::restic/*గా మరోసారి. S3లో bucket మరియు దాని objects వేర్వేరు resources. అందువల్ల వాటిలో ఒకదాని పేరును మాత్రమే ఇచ్చే policy విఫలమవుతుంది. ఇది client విరిగిపోయినట్లుగా కనిపించవచ్చు.
దానిపై ఆధారపడే ముందు ఈ పరిమితిని పరీక్షించండి.
mc alias set resticuser http://127.0.0.1:9000 restic-backup "$RESTIC_KEY"
mc ls resticuser/restic
mc ls resticuser/backupsమొదటి ls విజయవంతమవుతుంది. రెండోది Access Deniedతో విఫలమవుతుంది. మీరు పరీక్షించని policy కేవలం ఒక అంచనా మాత్రమే.
ఇప్పుడు resticను bucketకు సూచించండి. restic ప్రామాణిక AWS environment variables నుంచి S3 credentialsను చదువుతుంది. అందువల్ల restic-specific credential file అవసరం లేదు.
sudo apt install -y restic
export AWS_ACCESS_KEY_ID=restic-backup
export AWS_SECRET_ACCESS_KEY="$RESTIC_KEY"
restic -r s3:http://127.0.0.1:9000/restic init
restic -r s3:http://127.0.0.1:9000/restic backup /etc
restic -r s3:http://127.0.0.1:9000/restic snapshotsrestic init repository passwordను అడుగుతుంది. ఆ password repositoryని encrypt చేస్తుంది. కాబట్టి MinIO ఎప్పుడూ ciphertextనే నిల్వ చేస్తుంది. password పోతే backup కూడా పోతుంది. systemd timer ప్రారంభించే runకు టైప్ చేయడానికి terminal ఉండదు. అందువల్ల scheduled backups కోసం RESTIC_PASSWORD_FILEను mode 600 ఉన్న fileకు సెట్ చేయండి.
పై commands అన్నింటికంటే ఒక placement rule ముఖ్యమైనది. రక్షించే data ఉన్న అదే VPSలో restic repository ఉంటే, అది ఒక చెడు rm నుంచి మాత్రమే రక్షిస్తుంది. మరేదాని నుంచి రక్షించదు. MinIO node వేరే machineలో ఉండాలి. సాధ్యమైతే వేరే regionలో ఉండాలి. VPSలో restic backups దీనిపై scheduling మరియు retention వివరాలను అందిస్తుంది.
nginxతో TLSను ముగించడం
MinIO localhostలో మాత్రమే నడుస్తుంది. కాబట్టి బాహ్యంగా కనిపించే భాగం nginx. ముందుగా certbot మరియు nginxతో Let's Encrypt సర్టిఫికెట్లులో వివరించిన విధంగా సర్టిఫికెట్ను జారీ చేయండి. తర్వాత ఈ server blockను ఉపయోగించండి.
server {
listen 443 ssl;
server_name s3.example.com;
ignore_invalid_headers off;
client_max_body_size 0;
proxy_buffering off;
proxy_request_buffering off;
location / {
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 300;
proxy_http_version 1.1;
proxy_set_header Connection "";
chunked_transfer_encoding off;
proxy_pass http://127.0.0.1:9000;
}
}ఆ పంక్తుల్లో కొన్ని కీలకమైనవి. client_max_body_size 0 డిఫాల్ట్ 1 MB body పరిమితిని తొలగిస్తుంది. లేకపోతే MinIO అభ్యర్థనను చూడకముందే, పెద్ద uploadలను 413 Request Entity Too Largeతో తిరస్కరిస్తుంది. proxy_request_buffering off uploadను నేరుగా ముందుకు పంపుతుంది. డిఫాల్ట్ విధానం మొత్తం requestను ముందుగా తాత్కాలిక ఫైల్లో నిల్వ చేస్తుంది. అందువల్ల పెద్ద objectకు disk space రెండింతలు అవసరమవుతుంది. proxy_set_header Host $http_hostలోని విషయం కొంత సూక్ష్మమైనది. S3 signatureలో Host header కూడా ఉంటుంది. కాబట్టి proxy దాన్ని తిరిగి వ్రాస్తే ప్రతి request SignatureDoesNotMatchతో విఫలమవుతుంది. అయితే access logలో సాధారణ request వచ్చినట్లు కనిపిస్తుంది.
MinIOకు దాని బాహ్య పేరును కూడా తెలియజేయండి. అప్పుడు అది రూపొందించే links localhostకు కాకుండా proxyకి చూపుతాయి.
echo 'MINIO_SERVER_URL=https://s3.example.com' | sudo tee -a /etc/default/minio
sudo systemctl restart minioFirewall నియమాలు తక్కువగానే ఉంటాయి. SSH మరియు HTTPSను అనుమతించండి. 9000 మరియు 9001 portsకు ఎలాంటి ruleను జోడించవద్దు. ఎందుకంటే 127.0.0.1కు bind చేసిన addressను firewall ఏం చెబుతున్నా మరో machine నుంచి చేరుకోలేరు. ఆ commands కోసం VPSలో ufw firewall ప్రాథమికాలు చూడండి.
Single-node MinIO ఎప్పుడు సరిపోతుంది, నిజమైన S3 ఎప్పుడు కావాలి
ఇక్కడ single node అంటే ఒకే drive అని అర్థం. అందువల్ల deployment లో parity లేదా రెండవ copy ఉండదు. ప్రతి object యొక్క durability ఒకే VPS disk యొక్క durability పై ఆధారపడి ఉంటుంది. Hosted community docs ను October 2025లో తొలగించిన తరువాత, MinIO community documentation source రూపంలో minio/docs repository లో అందుబాటులో ఉంది. Source నుంచి compile చేసిన binaries ను ఉపయోగించే production environments కు ప్రమాదం తమ స్వంత బాధ్యతపై ఉంటుందని దాని server README చెబుతుంది. ఒక bucket కోసం object locking ను enable చేయవచ్చు. అయితే ఒక VPS లో అది S3 API ద్వారా చేసే deletion ను మాత్రమే ఆపుతుంది. Machine పై root access ఉన్న ఎవరైనా disk లోని files ను తొలగించగలరు. అందువల్ల ఈ setup పై immutable retention policy ఉందని ఎవరికీ హామీ ఇవ్వకండి.
ఇది మరో region లోని రెండవ VPS ను restic target గా ఉపయోగించడానికి, అలాగే development work మరియు CI artifacts కోసం S3 endpoint గా ఉపయోగించడానికి అనుకూలంగా ఉంటుంది. Bucket కోల్పోతే rebuild చేయడం తప్ప మరే పెద్ద నష్టం లేని సందర్భాల్లో ఇది సరైన ఎంపిక. చిన్న application లో user uploads కోసం కూడా ఇది సమంజసమే. అయితే recovery plan మీ వద్ద ఉండాలి. Restore ను వాస్తవంగా పరీక్షించి ఉండాలి.
Contract లేదా regulator object lock లేదా multi-region durability కోరినప్పుడు managed S3 ను ఎంచుకోండి. అలాగే disk నిండిపోయిందని 03:00 గంటలకు page అందుకుని స్పందించాల్సిన వ్యక్తిగా ఉండకూడదనుకుంటే కూడా managed S3 ను ఎంచుకోండి. Frozen code కూడా దీనికి మరో నిజాయితీగల కారణం. 20 October 2026 నాటికి community edition archive చేయబడింది. ఇక దాని maintenance కొనసాగదు. దాని చివరి release RELEASE.2025-10-15T17-29-55Z, మరియు ఈ guide compile చేసేది అదే release. దీని తరువాత ఏదీ fix చేయబడదు. కాబట్టి దీన్ని నడపడం అంటే ఈ పరిమితిని అంగీకరించడం. లేదా MinIO commercial AIStor line కు, మరొక self-hosted store కు మారాలి. దీనిని self-hosted MinIO alternatives పోల్చి వివరిస్తుంది.
తరచుగా ప్రస్తావనకు వచ్చే ఒక పరిమితిని స్పష్టంగా చెప్పాలి. Object storage database కాదు. Standard bucket లో ప్రతి write మొత్తం object ను replace చేస్తుంది. Amazon S3 Express One Zone కోసం జోడించిన append call కూడా data ను చివరికి మాత్రమే జోడిస్తుంది. అందువల్ల S3 bucket లోని live SQL file నెమ్మదిగా ఉండటమే కాకుండా సురక్షితం కూడా కాదు. Database ను local disk లో ఉంచి, దాని backup ను bucket లోకి పంపండి. ఈ విభజనను VPSపై productionలో SQLite నడపడం వివరిస్తుంది.
వైఫల్య రీతులు మరియు మీకు కనిపించే సందేశాలు
systemctl enable --now తర్వాత యూనిట్ విఫలమవుతుంది. journalctl -u minio -n 30 --no-pager చదవండి. Failed to load environment files: No such file or directory అంటే /etc/default/minio అందుబాటులో లేదు లేదా యూనిట్లో దాని పాత్ తప్పుగా ఉంది. permission denied తో ముగిసే సందేశం అంటే సర్వీస్ అకౌంట్కు డేటా డైరెక్టరీలో వ్రాసే అనుమతి లేదు, కాబట్టి stat -c '%U' /var/lib/minio/data కమాండ్ minio-user ని ప్రింట్ చేస్తుందో లేదో తనిఖీ చేయండి.
minioadmin:minioadmin ఇప్పటికీ లాగిన్ అవుతోంది. ఎన్విరాన్మెంట్ ఫైల్ ప్రాసెస్కు చేరలేదు. యూనిట్లో EnvironmentFile=/etc/default/minio ఉందని నిర్ధారించుకోండి, sudo systemctl daemon-reload రన్ చేయండి, ఆపై సర్వీస్ను రీస్టార్ట్ చేయండి. MinIO తన రూట్ క్రెడెన్షియల్స్ను స్టార్టప్లో ఒకసారి మాత్రమే చదువుతుంది, కాబట్టి రీస్టార్ట్ చేయకుండా ఆ ఫైల్ను ఎడిట్ చేస్తే ఎటువంటి మార్పు ఉండదు.
స్టార్టప్లో Address already in use. మరొక ప్రాసెస్ 9000 పోర్ట్ను ఆక్రమించింది. MinIO పోర్ట్ను మార్చే ముందు sudo ss -ltnp | grep :9000 తో ఆ ప్రాసెస్ను కనుగొనండి.
ప్రాక్సీ ద్వారా 1 MB కంటే ఎక్కువ పరిమాణం ఉన్న అప్లోడ్లు విఫలమవుతున్నాయి. nginx 413 Request Entity Too Large అని సమాధానమిచ్చింది మరియు MinIO ఆ అభ్యర్థనను చూడలేదు. సర్వర్ బ్లాక్లో client_max_body_size 0 ని సెట్ చేయండి.
SignatureDoesNotMatch. సీక్రెట్ కీ తప్పుగా ఉండవచ్చు, లేదా క్లయింట్ మరియు MinIO మధ్య ఏదైనా ప్రాసెస్ Host హెడర్ను మార్చి ఉండవచ్చు, ఇది సిగ్నేచర్లో భాగంగా ఉంటుంది.
RequestTimeTooSkewed. క్లయింట్ లేదా సర్వర్ గడియారంలో సమయం తప్పుగా ఉంది. ప్రతి సైన్డ్ S3 అభ్యర్థన ఒక టైమ్స్టాంప్ను కలిగి ఉంటుంది. Amazon S3 లాగానే, MinIO కూడా తన గడియార సమయం కంటే 15 నిమిషాల కంటే ఎక్కువ తేడా ఉన్న టైమ్స్టాంప్ కలిగిన హెడర్-సైన్డ్ అభ్యర్థనలను తిరస్కరిస్తుంది. ప్రీ-సైన్డ్ లింక్లను వాటి గడువు తేదీతో పోల్చి తనిఖీ చేస్తారు. timedatectl ని తనిఖీ చేయండి మరియు టైమ్ సింక్రొనైజేషన్ యాక్టివ్గా ఉందని నిర్ధారించుకోండి.
మీకు తెలిసిన బకెట్పై Access Denied. కీ వేరే బకెట్కు పరిమితం చేయబడింది. పాలసీ వాస్తవానికి దేనిని అనుమతిస్తుందో mc admin policy info local restic-rw తో ప్రింట్ చేయండి మరియు రిసోర్స్ లైన్లలోని బకెట్ పేరును సరిపోల్చండి.
FAQ
నిజమైన backups కోసం single-node MinIO సరిపోతుందా?
రక్షిస్తున్న data ఉన్న machine కు వేరుగా ఉన్న మరో machine పై restic target గా ఉపయోగిస్తే ఇది సరిపోతుంది. అయితే మీ వద్ద ఉన్న ఏకైక copy గా ఇది సరిపోదు. Single-drive deployment లో parity ఉండదు. అందువల్ల MinIO లో రెండో copy ఉండదు. ఆ VPS disk లో data కోల్పోతే objects కూడా పోతాయి. మరో ప్రదేశంలో రెండో target ఉంచండి. ప్రక్రియ సరిగ్గా పనిచేస్తోందని నిర్ధారించుకోవడానికి కనీసం ఒక్కసారి రెండు targets నుంచీ restore చేయండి.
MinIO యొక్క checksum file పై sha256sum -c ఎందుకు విఫలమవుతుంది?
ఈ guide పరిశీలించిన 20 October 2026 నాటికి, ఉపయోగించిన ప్రతి community binary మరియు checksum file కోసం పాత dl.min.io మార్గాలు 410 Gone కు సమాధానం ఇచ్చాయి. ఆ file లో hash తరువాత ఉన్న label release పేరును సూచిస్తుంది. ఉదాహరణకు minio.RELEASE.2025-09-07T16-13-09Z. అయితే downloaded file సాధారణంగా minio అని పిలవబడుతుంది. sha256sum -c checksum file లోపల వ్రాసిన పేరున్న file కోసం చూస్తుంది. అది దొరకకపోవడంతో No such file or directory మరియు WARNING: 1 listed file could not be read ను నివేదిస్తుంది. Download సరిగ్గానే ఉంది. Hash strings ను నేరుగా పోల్చండి. Security అర్థం లేని label ను పట్టించుకోకండి.
MinIO admin web console ఎక్కడికి వెళ్లింది?
May 2025 లో MinIO community edition console నుంచి administration features ను తొలగించింది. Web interface లో object browser మాత్రమే మిగిలింది. ఇప్పుడు buckets మరియు users ను mc client తో నిర్వహించాలి. ఇందుకోసం mc admin user add మరియు mc admin policy attach వంటి commands ఉపయోగించాలి. Workaround బదులుగా community edition లో ఇదే ఉద్దేశించిన విధానం. అందుకే ఈ guide లో అన్ని పనులు command line నుంచే చేస్తారు.
MinIO ను S3 backend గా ఉపయోగించేందుకు restic ను ఎలా configure చేయాలి?
AWS_ACCESS_KEY_ID మరియు AWS_SECRET_ACCESS_KEY ను MinIO access key మరియు దానికి సంబంధించిన secret కు set చేయండి. తరువాత s3:https://s3.example.com/restic రూపంలోని repository string ను ఉపయోగించండి. ఇందులో చివరి path element bucket పేరు. ముందుగా mc mb తో bucket ను సృష్టించండి. ఎందుకంటే ఒక bucket కు పరిమితం చేసిన key కు buckets సృష్టించే permission ఉండదు. Upload కు ముందు restic తన repository password తో అన్నింటినీ encrypt చేస్తుంది. అందువల్ల MinIO ciphertext ను మాత్రమే నిల్వ చేస్తుంది; మీ files ను ఎప్పుడూ చూడదు.
MinIO ను nginx వెనుక తప్పనిసరిగా నడపాలా?
Client అదే machine పై లేకపోతే TLS (transport layer security) అవసరం. TLS లేకుండా ప్రతి object access key ID మరియు request signature తో పాటు network పై plain text గా ప్రయాణిస్తుంది. Secret key client ను ఎప్పుడూ వదిలి బయటకు వెళ్లదు. S3 signing దాన్ని స్థానికంగా ఉపయోగించి ఆ signature ను లెక్కిస్తుంది. అయితే network మార్గంలో ఉన్న ఎవరైనా మీ data ను చదవగలరు. Timestamp చెల్లుబాటులో ఉన్నంత వరకు పట్టుబడిన request ను మళ్లీ పంపగలరు. Port 443 పై certbot certificate తో proxy ఏర్పాటు చేయడం TLS పొందడానికి సరళమైన మార్గం. దీని వల్ల certificate renewal బాధ్యత MinIO నుంచి వేరుగా ఉంటుంది. --certs-dir ను public.crt మరియు private.key ఉన్న directory కు point చేస్తే MinIO స్వయంగా TLS termination కూడా చేయగలదు. అయితే renewed private key ను చదవడానికి service account కు read access ఇవ్వాలి. అదే ఫలితం కోసం ఇది అదనపు పని.