VPS-এ Docker দিয়ে Supabase self-host করার গাইড
নিজের VPS-এ official Supabase Docker stack চালান। 11টি service-এর কাজ, বদলানোর secrets, RAM প্রয়োজন, backup এবং database না মুছে update করার নিয়ম জানুন।
আপনি যা তৈরি করছেন
Supabase self-host করার অর্থ হলো নিজের সার্ভারে অফিসিয়াল Docker Compose stack চালানো। এতে Postgres, এর সামনে একটি REST API, একটি auth service, file storage, realtime websockets এবং Studio dashboard থাকে। আপনি একটি repository clone করবেন, একটি .env file সম্পাদনা করবেন এবং এগারোটি container চালু করবেন। এগুলো একসঙ্গে এমন একটি Supabase project হিসেবে কাজ করবে, যার নিয়ন্ত্রণ আপনার হাতে থাকবে।
ইনস্টলেশনটি সংক্ষিপ্ত। সমস্যা সাধারণত .env file-এ হয়। এতে repository-তে প্রকাশিত demo secret থাকে। এই default-গুলো দিয়ে চালু করা stack যে কেউ খুঁজে পেলে তার জন্য উন্মুক্ত থাকে। এই guide-এ কোন secret প্রতিস্থাপন করতে হবে, প্রতিটি service-এর কাজ কী, stack-এর বাস্তবে কত memory প্রয়োজন এবং database মুছে না ফেলে কীভাবে এটি update করতে হবে—এসব ব্যাখ্যা করা হয়েছে।
Compose আপনার কাছে নতুন হলে আগে VPS-এ Docker Compose-এর প্রাথমিক বিষয় পড়ুন। নিচের সব নির্দেশনা ধরে নিচ্ছে যে docker compose version ইতিমধ্যে একটি version দেখায়।
স্ট্যাকটিতে আসলে কী রয়েছে
Supabase একটি মাত্র প্রোগ্রাম নয়। Compose file একই network-এ আলাদা আলাদা service চালু করে। কোন service কী কাজ করে তা জানলে অনেকগুলো container name-এর তালিকাকে debug করা সহজ হয়।
dbহলো Supabase extension লোড করা PostgreSQL। অন্য সব service এর সঙ্গে যোগাযোগ করে। এই container অস্বাভাবিক হলে অন্য সবকিছু ব্যর্থ হয়।api-gwহলো API gateway। August 2026 release থেকে এটি Envoy চালায়। এর আগে এটিkongনামের একটি service ছিল। Kong এখনও opt-in override হিসেবে ব্যবহার করা যায়। এটি port 8000-এ listening করে এবং/rest/v1/,/auth/v1/ও/storage/v1/সঠিক backend-এ route করে। যে container-টি বাইরে expose করা উচিত, এটি একমাত্র সেটিই।restহলো PostgREST। এটি আপনার Postgres schema পড়ে REST API হিসেবে পরিবেশন করে। তাই কোনো code না লিখেও নতুন table থেকে নতুন endpoint তৈরি হয়।authহলো GoTrue। এটি ব্যবহারকারীদের শনাক্ত করার জন্য JSON web token (JWT) জারি করে।storageএবংimgproxyfile upload ও image resize পরিচালনা করে।realtimewebsocket-এর মাধ্যমে database পরিবর্তন stream করে।studioএবংmetaহলো dashboard এবং এর পেছনের admin API।functionsহলো Deno ভিত্তিক edge runtime।supavisorহলো Postgres connection pooler।
Logs ও analytics-এর service (Logflare এবং vector) June 2026-এ default Compose file থেকে সরানো হয়েছে। এখন এগুলো একটি opt-in override file-এ রয়েছে। sh run.sh config add logs ব্যবহার করে এটি enable করতে হয়। এখানে একইভাবে Compose file layer করা হয়, যেমন একাধিক Compose file থেকে একটি stack চালানো অংশে বর্ণনা করা হয়েছে।
নিচের resource সংখ্যাগুলো কেন এমন, এই তালিকা তা ব্যাখ্যা করে। আপনি শুধু একটি database চালাচ্ছেন না। আপনি একটি database-এর সঙ্গে আরও দশটি support service চালাচ্ছেন।
Sizing: 8 GB RAM-এর পরিকল্পনা করুন
July 2026 অনুযায়ী, নতুন ইনস্টলে এই stack কোনো নিজস্ব data বা traffic ছাড়াই প্রায় 2.5 থেকে 3 GB resident memory ব্যবহার করে idle অবস্থায় ছিল। ওই পরিমাপে analytics service এবং Studio Node.js process ছিল এককভাবে সবচেয়ে বেশি memory ব্যবহারকারী দুটি component। Analytics এখন default stack-এর অংশ নয়। তাই logs override চালু করলেই কেবল এটি memory ব্যবহার করবে। 2 GB server container চালু করার পর kernel-এর out of memory killer একটি container বন্ধ করে দেবে। তখন container-টি exit code 137 নিয়ে বারবার restart হওয়ার অবস্থায় আটকে থাকবে। October 2026-এ যাচাই করা Supabase-এর self-hosting docs-এ minimum হিসেবে 4 GB RAM, 2 CPU core এবং 40 GB SSD উল্লেখ আছে। Recommended হিসেবে 8 GB RAM, 4 core এবং 80 GB উল্লেখ আছে।
যে workload-এর ওপর আপনি নির্ভর করেন, তার জন্য 8 GB RAM এবং 4 vCPU দিন। Heavy query এবং একই সময়ে Studio session ধীরগতির হলেও মেনে নিলে 4 GB একটি একক developer-এর development instance-এর জন্য কাজ করতে পারে। Disk-ও গুরুত্বপূর্ণ। কারণ Postgres, storage volume এবং logs চালু করলে log data—সবই project directory-এর অধীনে থাকে। 40 GB দিয়ে শুরু করুন এবং ব্যবহার পর্যবেক্ষণ করুন। Plan বাছাইয়ের আগে service-এর memory চাহিদা হিসাব করা self-hosted যেকোনো software-এর জন্য ভালো অভ্যাস। কারণ PhotoPrism এবং Immich-এরও বাস্তব RAM requirement আছে। October 2026-এ যাচাই করা Immich-এর quick start page-এ অন্তত 6 GB RAM এবং 2 CPU core চাওয়া হয়েছে। এখন আপনার project-এর জন্য এত শক্তিশালী server প্রয়োজন না হলে Supabase-এর free cloud plan-এ আসলে কী অন্তর্ভুক্ত আছে তা তুলনা করে দেখুন। এক সপ্তাহ idle না থাকা এবং 500 MB-এর নিচে থাকা একটি ছোট app সেখানে বিনা খরচে চালানো যেতে পারে।
ইনস্টল করুন: অফিসিয়াল repository clone করুন
সমর্থিত পদ্ধতিতে প্রধান repository থেকে docker directory আপনার নিজের একটি project directory-তে কপি করা হয়। এই পৃথকীকরণ গুরুত্বপূর্ণ, কারণ এর ফলে পরবর্তী git pull আপনার .env overwrite করতে পারে না।
git clone --depth 1 https://github.com/supabase/supabase
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cp supabase/docker/.env.example supabase-project/.env
cd supabase-project
docker compose pulldocker compose pull কয়েক গিগাবাইট image download করে। সব service Pulled হিসেবে চিহ্নিত হলে কমান্ডটি সম্পন্ন হয়েছে বলে ধরে নিন। এখানে manifest unknown error দেখালে বুঝতে হবে upstream থেকে নির্ধারিত image tag সরিয়ে ফেলা হয়েছে। tags হাতে edit না করে repository-এর নতুন copy pull করাই এর সমাধান।
প্রথমবার চালুর আগে যে secret-গুলো পরিবর্তন করতে হবে
স্ট্যাক চালু করার আগে এটি করুন, পরে নয়। এই মানগুলোর কয়েকটি প্রথম boot-এর সময় data-তে লেখা হয়। তাই পরে পরিবর্তন করতে হলে database reset করতে হবে।
repository-তে এমন একটি generator আছে, যা প্রতিটি মান সঠিকভাবে তৈরি করে। এর মধ্যে আপনার নতুন JWT secret দিয়ে sign করতে হবে এমন দুটি API key-ও রয়েছে।
sh utils/generate-keys.sh --update-envএই scriptটি JWT_SECRET, ANON_KEY, SERVICE_ROLE_KEY, SECRET_KEY_BASE, REALTIME_DB_ENC_KEY, VAULT_ENC_KEY, PG_META_CRYPTO_KEY, Logflare token, S3 protocol key এবং MINIO_ROOT_PASSWORD-এর জন্য নতুন মান .env-এ লেখে। October 2026 অনুযায়ী এটি POSTGRES_PASSWORD এবং DASHBOARD_PASSWORD-এর জন্যও random মান লেখে। এর জন্য openssl প্রয়োজন, যা যেকোনো সাধারণ Ubuntu image-এ থাকে। যেহেতু এটি এখন database password-ও নতুন করে লেখে, তাই --update-env ব্যবহার করে কেবল প্রথমবার চালুর আগে এটি চালান। ইতিমধ্যে data থাকা কোনো stack-এ এটি কখনো চালাবেন না।
.env-এ দুটি মান হাতে যাচাই করা এখনও উপযোগী:
POSTGRES_PASSWORD। Scriptটি এখানে random hex লেখে, যা নিরাপদ। নিজের মান ব্যবহার করলে শুধু অক্ষর ও digit ব্যবহার করুন। এখানে punctuation দিলে string জোড়া দিয়ে একাধিক service যে connection string তৈরি করে, সেগুলো নষ্ট হয়। ফলে parsing error-এর পরিবর্তে authentication error দেখা যায় এবং সমস্যাটি ভুল জায়গায় খোঁজা হয়।DASHBOARD_USERNAMEএবংDASHBOARD_PASSWORD। এগুলো Studio-এর basic authentication credential। Scriptটি random password সেট করে, কিন্তু username-এর defaultsupabaseরাখে। সরবরাহ করা default password আক্ষরিকভাবেthis_password_is_insecure_and_should_be_updated। তাই scriptটি না চালিয়ে থাকলে এখনই এটি পরিবর্তন করুন।
কেন ANON_KEY এবং SERVICE_ROLE_KEY নিজের মতো করে তৈরি করা যায় না, তা বুঝে নিন। দুটিই JWT_SECRET দিয়ে sign করা JWT। Gateway কেবল .env-এ থাকা নির্দিষ্ট key গ্রহণ করে। এর পেছনের service-গুলো JWT_SECRET-এর বিপরীতে signature যাচাই করে। তাই না-মেলা key HTTP 401 দিয়ে প্রত্যাখ্যাত হয়। Default Envoy gateway 401 Unauthorized-এর উত্তর দেয়। বর্তমান Kong override-ও একই উত্তর দেয়; এটি Kong 3.9 চালায় এবং {"message":"Unauthorized"} ফেরত দেয়। March 2026-এর আগের installation-গুলো Kong 2.8 চালাত এবং {"message":"Invalid authentication credentials"}-এর উত্তর দিত। Self-hosting-এ এটিই সবচেয়ে সাধারণ ব্যর্থতা: operator JWT_SECRET পরিবর্তন করেছেন, কিন্তু demo key রেখে দিয়েছেন। তিনটি key সবসময় একসঙ্গে তৈরি করুন।
SERVICE_ROLE_KEY-কে root password-এর মতো সুরক্ষিত রাখুন। এটি সম্পূর্ণভাবে row level security এড়িয়ে যায়। এটি server side code-এ থাকবে, অন্য কোথাও নয়।
SITE_URL-এ আপনার app-এর address এবং API_EXTERNAL_URL-এ API-এর public address লিখুন; শেষে /auth/v1 থাকবে। উদাহরণ: https://supabase.example.com/auth/v1। SUPABASE_PUBLIC_URL-এ path ছাড়া একই public address লিখুন। Auth এই মানগুলো থেকে email confirmation এবং OAuth callback link তৈরি করে। তাই localhost default রেখে দিলে আপনার প্রত্যেক user নিজের machine-এ পাঠানো হবে।
এরপর আপনার সেটিং যাচাই করুন:
sh run.sh secretsএটি চালু করুন এবং সুস্থ অবস্থায় আছে কি না নিশ্চিত করুন
sh run.sh start
docker compose psrun.sh start, docker compose up -d --wait-কে wrap করে। তাই health check পাস না করা পর্যন্ত এটি return করে না। প্রতিটি service-এ running (healthy) অথবা running দেখা উচিত। প্রথম boot-এ দুই থেকে চার মিনিট সময় লাগে, কারণ অন্য কোনো কিছু connect করার আগে Postgres তার initialisation script চালায়।
কোনো container যদি বারবার restart হয়, service name দিয়ে তার log পড়ুন:
docker compose logs db
docker compose logs authStudio এখন port 8000-এ চালু থাকবে। আপনি যে dashboard username ও password সেট করেছেন, এটি সেগুলো চাইবে।
পোর্ট 8000 public Internet-এ উন্মুক্ত করবেন না
8000 পোর্টের gateway সাধারণ HTTP ব্যবহার করে। প্রতিটি API key এবং প্রতিটি user password network-এ clear text হিসেবে যায়। Studio-এর credential-গুলো basic authentication ব্যবহার করে, যা encryption নয়, বরং base64 encoding।
এর সামনে একটি reverse proxy রাখুন এবং সেখানেই TLS (transport layer security) termination করুন। Gateway-কে loopback address-এ bind করুন, যাতে অন্য কোনো কিছু এটিতে পৌঁছাতে না পারে। docker-compose.yml-এ api-gw service-এর নিচের port line-টি 127.0.0.1:${API_GW_HTTP_PORT:-${KONG_HTTP_PORT:-8000}}:8000/tcp হয়ে যায়, এবং proxy সেটিতে অনুরোধ পাঠায়। August 2026-এ Envoy-এ পরিবর্তনের আগের install-এ একই port line kong নামের service-এর নিচে থাকে। Certificate ব্যবস্থাপনার দিকটি একাধিক Compose app-এর সামনে Traefik-এ ব্যাখ্যা করা হয়েছে। এই একই proxy শেষ পর্যন্ত এই stack থেকে শুরু করে 90s video store হিসেবে পুনর্নির্মিত Jellyfin library-এর মতো তুলনামূলকভাবে অগুরুত্বপূর্ণ service পর্যন্ত সার্ভারের অন্য সব কিছুর সামনেও থাকে। প্রতিটির জন্য আরেকটি open port-এর বদলে একটি hostname ব্যবহার করা উচিত। কোনো dashboard যদি শুধু আপনিই ব্যবহার করেন, তাহলে proxy বাদ দিয়ে SSH tunnel-এর মাধ্যমে loopback port-এ সংযোগ করুন। self-hosted open-kritt একই পদ্ধতিতে তার scanning interface-কে সম্পূর্ণ public Internet-এর বাইরে রাখে।
Firewall-এ বাকি port-গুলোও বন্ধ করুন। Docker নিজস্ব iptables rule লিখে port publish করে, কিন্তু সাধারণ ufw configuration সেগুলো দেখতে পায় না। এই সমস্যাটি Docker container কেন আপনার ufw rule উপেক্ষা করে-এ ব্যাখ্যা করা হয়েছে।
ডিরেক্টরি নয়, database-এর backup নিন
Postgres-এর data ./volumes/db/data-এর একটি bind mount-এ থাকে। Container চলার সময় ওই directory copy করলে অসম্পূর্ণ copy তৈরি হয়, কারণ Postgres write buffer করে এবং disk-এর file-গুলো শুধু checkpoint-এর সময় consistent থাকে। এটি restore করলে সাধারণত কাজ হবে, তবে কখনও কখনও শেষের transaction-গুলো নীরবে হারিয়ে যাবে। Backup-এর ক্ষেত্রে এটিই সবচেয়ে খারাপ ধরনের ব্যর্থতা।
এর পরিবর্তে dump নিন। pg_dumpall container-এর ভিতরে চলে এবং একটি consistent snapshot তৈরি করে:
docker exec -t supabase-db pg_dumpall -U postgres > supabase-$(date +%F).sqlফাইলটি ব্যবহারযোগ্য ধরে নেওয়ার আগে পরীক্ষা করুন যে এটি empty নয়। এরপর নির্ধারিত সময়সূচি অনুযায়ী ওই dump-গুলো server-এর বাইরে পাঠান। restic দিয়ে encrypted offsite backup-এর কাজ এটাই। নির্ধারিত dump নীরবে ব্যর্থ হলে তার ফল backup না থাকার মতোই। তাই cron বা systemd job non-zero exit করলে সেটিকে আপনার phone-এ alert পাঠাতে বলুন। একই সময়ে আপনার .env-এরও backup নিন। JWT_SECRET হারালে জারি করা প্রতিটি token invalid হয়ে যাবে এবং সংরক্ষিত প্রতিটি encrypted secret পড়া যাবে না।
Uploaded file-গুলো ./volumes/storage-এ থাকে। এগুলো সাধারণ file, তাই সাধারণ copy যথেষ্ট।
ডেটা না হারিয়ে আপডেট
Supabase docker-compose.yml-এ image version নির্দিষ্ট করে রাখে, তাই আপনি পরিবর্তন না করা পর্যন্ত কিছুই পরিবর্তিত হয় না। হাতে তৈরি করা যেকোনো stack-এ এই pinning পদ্ধতি ব্যবহার করা ভালো। এ কারণেই self-hosted RustDesk relay পরিবর্তনশীল tag অনুসরণ না করে তার দুটি server image নির্দিষ্ট করে রাখে। Upgrade এমন সময় করা উচিত, যখন আপনার হাতে সেটি সামলানোর জন্য যথেষ্ট সময় থাকে। প্রতিবার আগে dump নিন।
docker compose pull
sh run.sh recreaterecreate stack বন্ধ করে নতুন image দিয়ে আবার চালু করে। আপনার data অক্ষত থাকে, কারণ তা container-এর ভিতরে নয়, host-এর bind mount-এ থাকে। Major version পরিবর্তনের আগে repository-তে CHANGELOG.md পড়ুন, কারণ Postgres-এর major upgrade একটি পৃথক ধাপ এবং recreate এটি সম্পাদন করে না। June 2026 থেকে Postgres 17 default হিসেবে ব্যবহৃত হচ্ছে। Postgres 15-এ থাকা existing install sudo bash utils/upgrade-pg17.sh ব্যবহার করে এতে আপগ্রেড করা যায়। এটি data in place migrate করার জন্য pg_upgrade ব্যবহার করে এবং প্রতিটি major ধাপে confirmation চায়। এটির জন্য সব container চালু থাকা এবং আপনার database-এর আকারের অন্তত দ্বিগুণের সঙ্গে অতিরিক্ত 5 GB free disk space প্রয়োজন। কাজ শুরু করার আগে Supabase এখনও আপনার নিজস্ব independent backup নেওয়ার পরামর্শ দেয়।
Compose file-এ পরিবর্তন প্রয়োগ করতে project directory থেকে sh update.sh চালান। আগে কী পরিবর্তন হবে তা দেখতে sh update.sh --dry-run ব্যবহার করুন। এটি upstream file-গুলোর সঙ্গে আপনার করা edit merge করে। .env-এ থাকা existing value কখনও overwrite করে না; শুধু নতুন key যোগ করে। লেখার আগে এটি আপনার configuration backups/-এর অধীনে archive করে, তবে database archive করে না। .supabase-version file ছাড়া কোনো install-এর ক্ষেত্রে --from এবং যে release থেকে install শুরু হয়েছিল সেটি প্রয়োজন। August 2026-এর release-এর ক্ষেত্রে এটি বিশেষভাবে গুরুত্বপূর্ণ। ওই release-এ kong service-এর পরিবর্তে api-gw ব্যবহার করা হয়েছে এবং docker-compose.yml update প্রয়োজন। Manual পদ্ধতিও কাজ করে। Upstream repository আবার clone করুন এবং তার docker directory আপনার project-এর ওপর copy করুন। তবে .env overwrite না করার বিষয়ে সতর্ক থাকুন।
সম্পূর্ণ reset একটি পৃথক script-এর মাধ্যমে করা হয়। এতে database-সহ সবকিছু ধ্বংস হয় এবং .env default অবস্থায় ফিরিয়ে আনা হয়। আগেরটি .env.old হিসেবে রাখা হয়। Scriptটি confirmation চায়:
sh reset.shFAQ
আমার API call-এ "Invalid authentication credentials" ফেরত আসে কেন?
এই নির্দিষ্ট বার্তাটি Kong 2.8 থেকে আসে। এটি 2026 সালের March-এর আগে ইনস্টল করা stack-এর gateway। Default Envoy gateway এবং বর্তমান Kong override, যা Kong 3.9 চালায়, একই সমস্যা সাধারণ 401 Unauthorized হিসেবে জানায়। যেকোনো ক্ষেত্রেই, আপনার পাঠানো key .env-এর ANON_KEY বা SERVICE_ROLE_KEY-এর সঙ্গে মেলে না, অথবা সেই key-গুলো বর্তমানে .env-এ থাকা JWT_SECRET দিয়ে sign করা হয়নি। যে stack-এ আগে কখনো data রাখা হয়নি, সেখানে sh utils/generate-keys.sh --update-env ব্যবহার করে তিনটিই একসঙ্গে regenerate করুন। চলমান stack-এ flag ছাড়া script চালিয়ে no উত্তর দিন, যাতে এটি শুধু নতুন value print করে। এরপর JWT_SECRET, ANON_KEY এবং SERVICE_ROLE_KEY হাতে করে .env-এ কপি করুন এবং POSTGRES_PASSWORD অপরিবর্তিত রাখুন। তারপর sh run.sh recreate চালান, যাতে service-গুলো নতুন value পড়ে।
আমি কি 2 GB VPS-এ self-hosted Supabase চালাতে পারি?
নির্ভরযোগ্যভাবে নয়। 2026 সালের October অনুযায়ী Supabase-এর self-hosting documentation-এ 4 GB RAM-কে সর্বনিম্ন বলা হয়েছে। 2026 সালের July অনুযায়ী, logging service-সহ একটি measurement-এ stack idle অবস্থায় প্রায় 3 GB ব্যবহার করেছে; logging service এখন opt-in। 2 GB server-এ out of memory killer container বন্ধ করে দেয় এবং docker compose ps-এ exit code 137 দেখা যায়। Production-এর জন্য 8 GB ব্যবহার করুন। একক developer-এর development-এর ক্ষেত্রে 4 GB-কে সর্বনিম্ন সীমা হিসেবে ধরুন।
self-hosted Supabase-এ কি edge function অন্তর্ভুক্ত থাকে?
হ্যাঁ। Compose file-এ Deno ভিত্তিক functions runtime অন্তর্ভুক্ত থাকে এবং ./volumes/functions-এর অধীনে রাখা যেকোনো কিছু এটি serve করে। Hosted platform-এর global deployment network এতে অন্তর্ভুক্ত নয়। তাই আপনার function একটি location-এ, আপনার একটি server-এই চলে।
আমি কীভাবে সরাসরি Postgres database-এ সংযোগ করব?
Server-এর নিজস্ব interactive shell-এর জন্য docker exec -it supabase-db psql -U postgres ব্যবহার করুন। External client-এর ক্ষেত্রে port 5432-এ Supavisor-এর মাধ্যমে postgres.<POOLER_TENANT_ID> user এবং আপনার POSTGRES_PASSWORD ব্যবহার করে সংযোগ করুন। এই port Internet-এর জন্য খুলবেন না। VPN অথবা SSH tunnel-এর মাধ্যমে এতে পৌঁছান।
আমার auth confirmation email-এর link-এ localhost ছিল কেন?
.env-এর SITE_URL এবং API_EXTERNAL_URL default value-তে রাখা হয়েছিল। Auth service এই দুটি value থেকে প্রতিটি confirmation এবং password reset link তৈরি করে। তাই তাকে যে address পাঠাতে বলা হয়েছে, সে সেই address-ই পাঠায়। দুটিতেই আপনার প্রকৃত public URL সেট করুন এবং stack পুনরায় তৈরি করুন।