নিজের VPS-এ Dormice দিয়ে agent sandbox তৈরি করার নিয়ম
Dormice ব্যবহার করে কীভাবে আপনার নিজস্ব Linux VPS-এ E2B-compatible agent sandbox সেটআপ করবেন তা জানুন। অনিরাপদ কোড আইসোলেশনে চালানোর পদ্ধতি এবং সার্ভার সাইজিংয়ের বিস্তারিত গাইড।
Dormice কী এবং কী নয়
Dormice হলো একটি self-hosted agent sandbox: এটি আপনার নিজস্ব Linux VPS-এ চলমান একটি daemon, যা আপনার agent code-এর HTTP অনুরোধের মাধ্যমে অনিরাপদ (untrusted) কোডকে একটি isolated container-এর ভেতরে চালায়। আপনার প্রোগ্রাম নাম ধরে sandbox-এর অনুরোধ করে, আগের যেকোনো অবস্থায় থাকা সেই একই sandbox ফিরে পায়, তার ভেতরে একটি কমান্ড চালায় এবং আউটপুট পড়ে। এই sandbox একটি programmatic resource, এটি এমন কোনো মেশিন নয় যেখানে আপনি লগ-ইন করবেন।
এটি একটি agent-কে পুরো কম্পিউটার দেওয়ার চেয়ে ভিন্ন। একটি coding agent-এর জন্য throwaway VM হলো এমন একটি বক্স যেখানে আপনি SSH করেন, agent-কে সেটি নষ্ট করতে দেন, তারপর মুছে ফেলেন। Dormice এক ধাপ নিচে অবস্থান করে: এটি একটি execution API, যা আপনার প্রোগ্রাম তখন কল করে যখন তার হাতে কোড থাকে এবং সেটি চালানোর জন্য একটি নিরাপদ জায়গা প্রয়োজন হয়। যখন কাজের একক হিসেবে একটি পুরো মেশিনের প্রয়োজন হয়, তখন throwaway VM ব্যবহার করুন। যখন কাজের একক হিসেবে একটি মাত্র exec কল প্রয়োজন হয় এবং আপনি প্রতিদিন শত শত VM তৈরি না করেই তা করতে চান, তখন Dormice ব্যবহার করুন।
এই প্রজেক্টটি নিজেকে E2B compatible বলে দাবি করে। E2B হলো একটি hosted sandbox service, যার client library অনেক agent framework ইতিমধ্যে import করে থাকে। Dormice নিজস্ব URL prefix-এর অধীনে একই protocol প্রদান করে, তাই অফিসিয়াল e2b package ব্যবহার করে লেখা কোনো application আপনার নিজস্ব বক্সে পয়েন্ট করলে তা সচল থাকে। application code-এর কোনো পরিবর্তন করতে হয় না। শুধু দুটি URL এবং একটি API key prefix পরিবর্তন করতে হয়।
বাস্তবে “agent sandbox-এর SQLite” বলতে কী বোঝায়
SQLite এমন একটি database, যা আপনি পরিচালনা করা service-এর পরিবর্তে embed করেন। Dormice সরাসরি এই তুলনাটি ব্যবহার করে। প্রতি machine-এ একটি daemon, তার ledger-এর জন্য একটি SQLite file এবং একটি TCP port থাকে। এর পাশে একটি ছোট gateway install করা থাকে, যা web console পরিবেশন করে। Kubernetes বা external database server-এর প্রয়োজন নেই। daemon তার ledger-এর পাশে exclusive lock নেয়। তাই একই machine-এ দ্বিতীয় daemon নীরবে state ভাগ না করে start হতে অস্বীকার করে। প্রতিটি sandbox যে machine-এ তৈরি হয়েছে, সেখানেই থাকে। README-তে এখন একটি fleet-কে একটি gateway এবং তার private network-এ থাকা machine-গুলোর সমষ্টি হিসেবে বর্ণনা করা হয়েছে। তবে সেখানে এখনও বলা আছে, sandbox যদি machine-এর মধ্যে স্থানান্তর করতে হয় বা একাধিক region জুড়ে fleet দরকার হয়, তাহলে অন্য কোনো সমাধান বেছে নেওয়া উচিত। এই সীমাবদ্ধতাটি গুরুত্ব দিয়ে বিবেচনা করুন।
এই ধারণার দ্বিতীয় দিকটি খরচ নিয়ে। Hosted sandbox যতক্ষণ চালু থাকে, ততক্ষণ প্রতি second-এর জন্য billing হয়। তাই hosted sandbox সাধারণত disposable হিসেবে নকশা করা হয়। Dormice আপনি ইতিমধ্যে যে hardware-এর জন্য অর্থ দিচ্ছেন, তাতেই চলে। ফলে এর sandbox স্থায়ী থাকে এবং যত বেশি সময় অপরিবর্তিত অবস্থায় থাকে, তত কম খরচে পরিচালিত হয়। একটি sandbox ধাপে ধাপে idle অবস্থায় যায়: active, তারপর frozen, তারপর stopped, এবং শেষে archived। যেকোনো acquire এটিকে যে ধাপেই থাকুক, সেখান থেকে আবার চালু করে।
Freezing অংশটি বোঝা গুরুত্বপূর্ণ। কারণ এর মাধ্যমেই প্রতিটি agent-এর sandbox স্থায়ীভাবে রাখা সাশ্রয়ী হয়। নিচের সংখ্যাগুলো প্রকল্পটির প্রকাশিত নিজস্ব পরিমাপ। এগুলো প্রকল্পের hardware-এ মাপা হয়েছে, আপনার hardware-এ নয়।
এই চার্টের পেছনের ডেটা
[
{
"label": "Active, holding 1 GiB",
"resident_memory_mib": 1024,
"wake_ms": 0
},
{
"label": "Frozen",
"resident_memory_mib": 5,
"wake_ms": 50
}
]একটি idle sandbox-এ 1024 MiB memory থাকলে, frozen হওয়ার পরে তার resident memory 5 MiB-তে নেমে যায় এবং প্রায় 50 ms-এর মধ্যে আবার চালু হয়। Process-গুলো একই অবস্থায় suspend ও resume হয়। তাই দীর্ঘ সময় চলা agent freeze-এর পরেও তার shell state এবং অসমাপ্ত কাজ ধরে রাখে। Capacity পরিকল্পনা করার আগে নিজের host-এ এটি পুনরায় পরীক্ষা করুন।
ইনস্টল করার আগে host-এর যা প্রয়োজন
host-এ x86_64 আর্কিটেকচারের Ubuntu বা Debian থাকতে হবে, এবং installer-এর root প্রয়োজন। daemon runtime-এও root হিসেবে চলে, কারণ এটি loop mount তৈরি করে এবং cgroups-এ লেখে।
Sandbox-গুলো gVisor-সহ Docker-এর অধীনে চলে। gVisor এমন একটি container runtime, যা container এবং host kernel-এর মধ্যে userspace kernel বসায়। এটি প্রতিটি sandbox-এর ব্যবহৃত runsc runtime সরবরাহ করে। daemon চালাতে Node 22 বা তার পরের সংস্করণ প্রয়োজন। আপনার system Node-এর সংস্করণ ইতিমধ্যে 22 বা তার পরের হলে installer সেটিই ব্যবহার করবে। Node অনুপস্থিত বা পুরোনো হলেই installer নিজস্ব pinned copy download করবে, checksum যাচাই করবে এবং /opt-এর অধীনে unpack করবে।
Swap থাকতে হবে এবং vm.swappiness-এর মান 100 হতে হবে। এটি tuning-এর পরামর্শ নয়; এটি কার্যকর হওয়ার বাধ্যতামূলক শর্ত। Idle sandbox-এর memory swap-এ সরিয়ে freezing কাজ করে। gVisor sandbox-এর memory shared memory হিসেবে ধরে রাখে, আর default swappiness-এ kernel shared memory swap করবে না। Project-এর পরিমাপে default মানে 0 bytes reclaim করা হয়েছে, কিন্তু 100 মানে 99.5 percent reclaim করা হয়েছে। Kernel আসলে কোন মান ব্যবহার করছে তা পরীক্ষা করুন, কারণ কিছু cloud image vm.swappiness = 0 এমন একটি file-এ সেট করে, যা আপনি সাধারণত পড়ার কথা ভাববেন না।
sysctl vm.swappiness
swapon --showsysctl vm.swappiness-এর আউটপুট vm.swappiness = 100 হওয়া উচিত, এবং swapon --show একটি swapfile দেখানো উচিত। swappiness-এর আউটপুট 0 হলে প্রতিটি freeze কার্যত কোনো কাজ করবে না, ফলে প্রতিটি idle sandbox-এর জন্য আপনাকে সম্পূর্ণ memory খরচ করতে হবে।
Ubuntu-তে Dormice ইনস্টল করুন
নথিভুক্ত ইনস্টল পদ্ধতিতে একটি pipe দিয়ে bash চালানো হয়:
curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh | bashচালানোর আগে এটি সংগ্রহ করে পড়ে নিন। এই script-টি root হিসেবে চলে এবং আপনার host-এ পরিবর্তন আনে: Docker না থাকলে এটি ইনস্টল করে, checksum যাচাই করে gVisor ও Caddy ডাউনলোড করে, host-এ swap না থাকলে একটি swapfile তৈরি করে, daemon, gateway এবং image registry-এর জন্য systemd unit লেখে, এবং firewall rule যোগ করে।
curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh -o dormice-install.sh
less dormice-install.sh
sudo bash dormice-install.sh --swap-gb 8--swap-gb swapfile-এর আকার নির্ধারণ করে এবং default মান 16; ছোট VPS-এ এত disk বরাদ্দ করা অনেক বেশি। --mirror cn ডাউনলোডের জন্য mainland China থেকে পৌঁছানো যায় এমন mirror ব্যবহার করে। Installer আবার চালালে code upgrade হয় এবং drift মেরামত হয়; এটি কখনো আপনার API token পরিবর্তন করে না।
Code /opt/dormice-এ, configuration /etc/dormice/env-এ, এবং gateway-এর configuration অতিরিক্তভাবে /etc/dormice/gateway.env-এ থাকে। Sandbox data থাকে /var/lib/dormice-এ, আর dormice ও dor command থাকে /usr/local/bin-এ। Installer ইনস্টলের সময় API token তৈরি করে এবং সেটি mode 600 সহ /etc/dormice/env-এ লেখে। একই value gateway-এর file-এও লেখা হয়।
ইনস্টল করার মতো কোনো tagged release নেই। 12 October 2026 অনুযায়ী repository-তে কোনো git tag বা GitHub release নেই। তাই installer main clone করে এবং সেই সকালে repository-তে থাকা code-ই আপনি পান। ফলে কোনো version pin করতে হলে আপনি যে commit ইনস্টল করেছেন, সেটি লিখে রাখতে হবে।
git -C /opt/dormice rev-parse HEADসেই hash আপনার deploy note-এর সঙ্গে সংরক্ষণ করুন। এতে আপনি ঠিক কোন code চালাচ্ছেন তা জানা যায়। তবে এটি একাই আগের অবস্থায় ফেরার উপায় নয়: নতুন process boot হওয়ার সময় database migration প্রয়োগ করে, এবং upgrade documentation অনুযায়ী পুরোনো installer আবার চালালে migration প্রত্যাহার হয় না। কিছু restart করার আগে installer উভয় database-এর snapshot /var/lib/dormice/backups/-এ সংরক্ষণ করে এবং সর্বশেষ তিনটি snapshot রাখে। খারাপ upgrade-এর পরে ফিরে যাওয়ার নথিভুক্ত উপায় হলো এই snapshot। তাই আবার upgrade করার আগে সর্বশেষ snapshot-টি host-এর বাইরে কপি করে রাখুন।
Installer শেষে dor doctor চালায়। এটি একটি read-only host check, যা package list-এর ওপর নির্ভর না করে বাস্তব gVisor container boot করে runtime কাজ করছে কি না যাচাই করে। Daemon অস্বাভাবিক আচরণ করলে এটি আবার চালান।
sudo dor doctor
systemctl is-active dormicesystemctl is-active dormice-এর আউটপুটে active দেখা উচিত। যদি failed দেখা যায়, তাহলে journalctl -u dormice -n 50-এ কারণটি থাকে। Failed start সাধারণত daemon-এর নিজের সমস্যার বদলে swap বা gVisor prerequisite-এর কারণে হয়।
Installer host-এ Caddy-ও ইনস্টল করে। তাই firewall-এর কাজ শেষ হয়েছে ধরে নেওয়ার আগে কোন service কোন port-এ listening করছে তা দেখুন।
sudo ss -lntpDaemon সবসময় 127.0.0.1-এ bind করে। নকশা অনুযায়ী এই address পরিবর্তন করার কোনো setting নেই। শুধু port পরিবর্তন করা যায়: DORMICE_PORT-এর default মান 3676। এর পাশের gateway-ও 127.0.0.1:3677-এ একই নিয়ম অনুসরণ করে। এর port-এর জন্য DORMICE_GATEWAY_PORT ব্যবহৃত হয় এবং ইচ্ছাকৃতভাবে কোনো host setting নেই। আপনার laptop থেকে যেকোনোটিতে পৌঁছানো একটি সচেতনভাবে নেওয়া পদক্ষেপ। সহজ ও কম খরচের পদ্ধতি হলো SSH tunnel, যা উভয় port forward করে।
ssh -L 3676:127.0.0.1:3676 -L 3677:127.0.0.1:3677 root@your-serverTunnel চালু থাকলে আপনার laptop-এ http://127.0.0.1:3677/console হলো web console, যা gateway পরিবেশন করে। প্রথমবার প্রবেশের সময় একবার API token paste করে প্রমাণ করুন যে আপনি operator। এরপর console username ও password সেট করুন। Sign in করলে একটি httpOnly session cookie সেট হয়, যা 7 দিন কার্যকর থাকে এবং page JavaScript পড়তে পারে না। Console কখনো token আবার দেখায় না। সেখানকার Connect page-এ copy-and-paste করার মতো client snippet দেখানো হয়, যা আগে থেকেই আপনার নিজের endpoint-এ নির্দেশ করা থাকে।
একটি sandbox তৈরি করুন এবং এতে code চালান
একটি operation sandbox তৈরি করে: acquire। এটি idempotent, তাই একই key প্রতিবার একই sandbox ফেরত দেয় এবং প্রয়োজনে সেটি তৈরি, জাগিয়ে, চালু বা restore করে। অন্য প্রতিটি verb এমন key-এর ক্ষেত্রে 404 ফেরত দেয়, যেটি আগে কখনও দেখা হয়নি। dor CLI-তে acquire verb নেই, তাই আপনার প্রথম sandbox console অথবা client library থেকে তৈরি করতে হবে।
Console route-ই দ্রুততম। Tunnel-এর মাধ্যমে /console খুলে my-agent নামে একটি sandbox তৈরি করুন। এরপর CLI সেটির ওপর কাজ করবে।
sudo grep DORMICE_API_TOKEN /etc/dormice/env
export DORMICE_ENDPOINT=http://127.0.0.1:3676
export DORMICE_API_TOKEN=paste-the-value-here
dor sandbox ls
dor sandbox exec my-agent 'python3 --version'dor sandbox ls প্রতিটি sandbox-এর lifecycle state তালিকাভুক্ত করে। এভাবেই active থেকে frozen হওয়ার পরিবর্তন পর্যবেক্ষণ করা যায়। dor sandbox exec Python 3.12-এর version দেখায়, কারণ stock image-এ Ubuntu 24.04, Python 3.12, Node 24, git এবং ripgrep আগে থেকেই installed থাকে। এর বদলে authentication error দেখা গেলে বুঝতে হবে, আপনি যে token line কপি করেছেন তাতে variable name-ও অন্তর্ভুক্ত হয়েছে।
dor sandbox push my-agent ./script.py দিয়ে file স্থানান্তর করা হয় এবং সেটি /home/user/script.py-এ গিয়ে পৌঁছায়। dor sandbox pull my-agent notes.txt দিয়ে file ফিরিয়ে আনা হয়। Native file verb-গুলোর সীমা প্রতি file-এ 16 MiB। অন্যদিকে E2B file surface stream ব্যবহার করে, তাই একমাত্র সীমা হয় sandbox-এর disk quota।
Destroy করাই একমাত্র verb, যার ফলে data হারায়। dor sandbox destroy my-agent sandbox সরিয়ে দেয় এবং এটি idempotent। প্রধান README, bundled agent skill এবং CLI package README—সবখানেই এটি একই নামে documented। তবু নিজের build-এ dor sandbox --help চালান, কারণ installer main track করে এবং CLI-তে ক্রমাগত নতুন feature যোগ হচ্ছে।
আপনার বিদ্যমান E2B কোডকে আপনার নিজস্ব সার্ভারের দিকে নির্দেশ করুন
এটির জন্যই এই বিষয়টি গুরুত্বপূর্ণ। npm থেকে প্রাপ্ত অফিসিয়াল e2b প্যাকেজটি কোনো পরিবর্তন ছাড়াই Dormice-এর সাথে যোগাযোগ করে। SSH tunnel খোলা থাকা অবস্থায় আপনার ল্যাপটপ থেকে এটি চালান, যাতে সার্ভারে নতুন কোনো কিছু listen না করে।
npm init -y
npm i e2b tsximport { Sandbox } from 'e2b';
const sbx = await Sandbox.create({
apiKey: `e2b_${process.env.DORMICE_API_TOKEN}`,
apiUrl: 'http://127.0.0.1:3676/e2b/api',
sandboxUrl: 'http://127.0.0.1:3676/e2b/envd',
});
const result = await sbx.commands.run('python3 -c "print(6 * 7)"');
console.log(result.exitCode, result.stdout);
await sbx.kill();DORMICE_API_TOKEN=paste-the-value-here npx tsx index.tsএকটি সফল রান exit code 0 এবং 42 প্রদর্শন করবে। API key হলো আপনার Dormice token, যার শুরুতে একটি e2b_ prefix যুক্ত থাকবে; compatibility layer এই ফরম্যাটটিই প্রত্যাশা করে।
এই compatibility কোনো stub নয়। অফিসিয়াল প্যাকেজের মাধ্যমে একটি প্রকৃত Docker এবং gVisor daemon-এর বিপরীতে প্রজেক্টের end-to-end suite ব্যবহার করে stdout ও stderr স্ট্রিমিং, background commands, একটি interactive PTY, signed upload ও download URL, directory watching এবং একটি port proxy-এর কার্যকারিতা যাচাই করা হয়। কোনো গুরুত্বপূর্ণ কাজ মাইগ্রেট করার আগে নিচের পার্থক্যগুলো জেনে রাখা জরুরি:
- Template build-এর সুবিধা এখানে নেই। একটি template হলো এমন একটি docker image যা আপনি নিজে তৈরি করেন এবং
dor template addদিয়ে register করেন, আরSandbox.create('name')সেটিকে resolve করে। কোনো unregistered নাম ব্যবহার করলে এটি কোনো ভান না করে সরাসরি 404 error প্রদান করে। - E2B ইন্টারফেসের মাধ্যমে তৈরি করা sandbox-গুলোর জন্য নির্দিষ্ট সময়সীমা (deadlines) থাকে, কারণ E2B-এর নিয়ম অনুযায়ী এটি প্রয়োজন। কিন্তু native API-এর মাধ্যমে তৈরি করা sandbox-এ কোনো সময়সীমা আরোপ করা হয় না।
- একটি frozen sandbox তার প্রসেসগুলোকে ধরে রাখে এবং মাঝপথ থেকেই পুনরায় শুরু করে। তাই এখানে pause এবং resume মানে আপনার পরিচিত stop এবং cold start নয়।
স্যান্ডবক্স কী থামায় এবং কী থামায় না
gVisor userspace-এ container-এর system call intercept করে এবং নিজেই সেগুলো service দেয়। তাই sandbox-এর code সরাসরি আপনার host kernel-এর সঙ্গে কথা বলে না। Sandbox-এর ভিতরে command-গুলো user (uid 1000) হিসেবে চলে। তবে ওই account-এ password ছাড়াই sudo ব্যবহার করা যায়। তাই যে code এটি চাইবে, তার জন্য sandbox-এর ভিতরে root পাওয়া সম্ভব। uid-কে protection হিসেবে বিবেচনা করবেন না। প্রকল্পটি স্পষ্টভাবে জানায়, security boundary হলো gVisor, uid নয়। কোনো sandbox নিজে privilege বাড়ালেও host kernel-এ পৌঁছাতে পারে না। সাধারণ ক্ষেত্রে এটিই যথেষ্ট: কোনো generated script rm -rf / চালালে, disk পূর্ণ করলে বা কোনো process শেষ না হওয়া পর্যন্ত fork করলে, ক্ষতি তার নিজের sandbox-এই সীমাবদ্ধ থাকবে।
তবে এটি যা থামায় না, সেগুলো নিচে দেওয়া হলো। এগুলোর দায়িত্ব আপনার।
- Sandbox-এ outbound network কাজ করে। Generated code ইচ্ছামতো যেকোনো কিছু download এবং যা পায় তা post করতে পারে। Installer-এর network hardening দুটি নির্দিষ্ট বিষয় সামলায়: এটি 169.254.0.0/16 এবং 100.100.100.200-এ container traffic drop করে। 100.100.100.200 হলো Alibaba Cloud ব্যবহৃত address। কোনো cloud instance credential-এ পৌঁছাতে পারে এমন সব কিছুকে cloud এই address-এ credential দেয়। এছাড়া এটি Docker-এর
daemon.json-এ"icc": falseব্যবহার করে container-to-container traffic বন্ধ করে। অন্য কিছু blocked নয়।sudo iptables -S DOCKER-USERপড়ুন এবং যে private range-এ sandbox-এর পৌঁছানোর কোনো কারণ নেই, সেগুলোর জন্য নিজের DROP rule যোগ করুন। - Docker আপনার firewall-এর আগে নিজের rule বসায়। তাই published container port Internet থেকে response দিতে পারে, যদিও ufw সেটিকে closed বলে দেখায়। এই host-এ কোনো কিছু expose করার আগে Docker কীভাবে ufw-এর পাশ দিয়ে port publish করে এবং VPS-এর জন্য ufw firewall-এর মৌলিক বিষয় পড়ুন।
- gVisor হলো userspace kernel, hypervisor নয়। এটি ইচ্ছাকৃত trade-off। কারণ freezing-এর জন্য sandbox-কে process হতে হয়, আর KVM বাধ্যতামূলক করলে এটি কোনো জায়গায় install করা সম্ভব হবে না। আপনার threat model-এ hardware virtualisation আবশ্যক হলে Firecracker-class isolation ব্যবহার করুন এবং এর সঙ্গে আসা operational cost মেনে নিন।
- Client side-এ API token-ই সম্পূর্ণ security boundary।
DORMICE_API_TOKENহাতে থাকা যেকেউ machine-এর প্রতিটি sandbox create, read এবং destroy করতে পারে। Agent process-এর জন্য নিজের VPS-এ least privilege user দিন এবং token-কে যেভাবে SSH key-এর নিরাপত্তা বজায় রাখেন, সেভাবেই পরিচালনা করুন। VPS-এ Claude Code নিরাপদে চালানোর অভ্যাসগুলো সরাসরি প্রযোজ্য।
Daemon নিজে আপনার host-এ root হিসেবে চলে। gVisor sandbox-এর ভিতরের code থেকে host-কে রক্ষা করে। কিন্তু daemon বা যার কাছে token আছে, তাদের কাছ থেকে host-কে কিছুই রক্ষা করে না। তাই Dormice চালানো machine-এ শুধু Dormice-ই চালানো উচিত। আপনার agent যদি MCP (model context protocol)-এর মাধ্যমে tool-এও পৌঁছায়, একই কারণে সেই MCP server-গুলো আলাদা VPS-এ রাখুন।
4 GB এবং 8 GB র্যামে কয়টি স্যান্ডবক্স চালানো সম্ভব?
মেমরি মূলত দুটি জিনিসের ওপর নির্ভর করে: হোস্টের নিজস্ব বেসলাইন এবং বর্তমানে সচল প্রতিটি স্যান্ডবক্সের ওয়ার্কিং সেট। Ubuntu, Docker এবং ডেমনের জন্য প্রায় 1 GB মেমরি আলাদা রাখুন। এরপর অবশিষ্ট মেমরিকে একটি স্যান্ডবক্সের প্রকৃত ব্যবহারযোগ্য মেমরি দিয়ে ভাগ করুন। একটি পাইথন স্ক্রিপ্ট যা কয়েকটি ফাইল পড়ে, সেটি সাধারণত 200 থেকে 300 MiB মেমরি ব্যবহার করে। কিন্তু একটি কম্পাইলার বা পূর্ণাঙ্গ টেস্ট স্যুট চললে তা এক গিবিবাইট (GiB) ছাড়িয়ে যেতে পারে।
এই চার্টের পেছনের ডেটা
[
{
"host": "4 GB VPS",
"active_at_512_mib": 6,
"active_at_1_gib": 3,
"frozen_on_16gb_swap": 16
},
{
"host": "8 GB VPS",
"active_at_512_mib": 14,
"active_at_1_gib": 7,
"frozen_on_16gb_swap": 16
}
]একটি 4 GB VPS-এ একই সময়ে 6 টি স্যান্ডবক্স সচল রাখা সম্ভব যদি প্রতিটি 512 MiB মেমরি ব্যবহার করে, অথবা 3 টি স্যান্ডবক্স সচল রাখা সম্ভব যদি প্রতিটি এক গিবিবাইট মেমরি ব্যবহার করে। 8 GB VPS-এর ক্ষেত্রে এই সংখ্যা যথাক্রমে 14 এবং 7। এগুলো মূলত সমসাময়িক কাজের সর্বোচ্চ সীমা এবং এটি একটি গাণিতিক হিসাব, কোনো বেঞ্চমার্ক নয়। তাই আপনার নিজস্ব লোড চলার সময় free -m মনিটর করুন।
ফ্রোজেন (frozen) স্যান্ডবক্সগুলো র্যামের পরিবর্তে সোয়াপ (swap) দ্বারা সীমাবদ্ধ, যা এই ডিজাইনের মূল উদ্দেশ্য। একটি ফ্রোজেন স্যান্ডবক্স যা এক গিবিবাইট মেমরি দখল করে ছিল, তা সোয়াপে প্রায় সমপরিমাণ জায়গা নেয় এবং র্যামে প্রায় কিছুই রাখে না। তাই ইনস্টলারের ডিফল্ট 16 GB সোয়াপফাইল প্রায় 16 টি স্যান্ডবক্স ধরে রাখতে পারে। এর চেয়ে বেশি স্যান্ডবক্স হলে সেগুলোকে 'stopped' অবস্থায় রাখতে হবে, যেখানে সেগুলো শুধুমাত্র ডিস্কের জায়গা দখল করে। দীর্ঘমেয়াদে ডিস্কের ধারণক্ষমতাই এখানে আসল সীমাবদ্ধতা: প্রতিটি স্যান্ডবক্স তার নিজস্ব ফাইলসিস্টেম বজায় রাখে এবং কয়েক ডজন এজেন্ট, যার প্রতিটিতে একটি করে node_modules ডিরেক্টরি থাকে, তা মেমরি সমস্যার আগেই একটি ছোট ভলিউম পূর্ণ করে ফেলতে পারে।
নিষ্ক্রিয় অবস্থায় freeze, বন্ধ, archive: lifecycle নিয়ন্ত্রণ
ডিফল্ট আচরণ হলো 10 মিনিট নিষ্ক্রিয় থাকার পরে freeze করা, 3 দিন পরে stop করা, এবং archiving কনফিগার করা থাকলে 7 দিন পরে archive করা। stopAfterSeconds-এর মান null সেট করলে একটি resident agent পাওয়া যায়: নিষ্ক্রিয় অবস্থায় এটি freeze হতে পারে, কিন্তু কখনও cold start করে না।
Archiving ঐচ্ছিক, এবং daemon এ বিষয়ে স্পষ্ট থাকে। Console-এর settings page-এ একটি S3-compatible store কনফিগার করুন (চারটি DORMICE_S3_* variable এখনও বিদ্যমান, তবে সেগুলো শুধু gateway-এর প্রথম boot-এর seed হিসেবে ব্যবহৃত হয়)। এরপর stopped sandbox-এর disk tar এবং zstd দিয়ে pack করা হয়, bucket-এ পাঠানো হয় এবং local disk থেকে সরিয়ে দেওয়া হয়। সেই bucket আপনার অন্য একটি মেশিনে নিজে host করা MinIO bucket হতে পারে। Store কনফিগার না করলে sandbox-গুলো অনির্দিষ্টকাল stopped অবস্থায় থাকে, এবং archive করার অনুরোধ করা policy নীরবে উপেক্ষা না করে প্রত্যাখ্যান করা হয়। Restore প্রক্রিয়া নীরব নয়: পরবর্তী acquire request সঙ্গে সঙ্গে restoring status এবং একটি progress value ফেরত দেয়, তারপর disk ফিরে এলে status ready হয়।
এখনই কি এর ওপর নির্ভর করা উচিত?
সরাসরি উত্তর: এমন কোনো কাজে নয় যা আপনি পুনর্নির্মাণ করতে পারবেন না। Repository-টি 8 July 2026-এ তৈরি হয়েছে। 12 October 2026 পর্যন্ত এতে 1,509 stars, 109 forks, একটি Apache-2.0 licence এবং কোনো tagged release নেই। README-এর নিজস্ব status line-এও বলা আছে যে production-এর জন্য এখনো কিছু প্রস্তুত নয়।
এই সমন্বয়টি নির্দিষ্ট ধরনের ঝুঁকি তৈরি করে। Installer main অনুসরণ করে, তাই code আপনার নিয়ন্ত্রণের বাইরে পরিবর্তিত হতে পারে। Interface এখনো স্থির হয়নি: documentation-এ এখন daemon-এর সামনে একটি gateway-এর কথা বলা হয়েছে, যার নিজস্ব port, configuration file এবং database রয়েছে। প্রায় তিন মাস পুরোনো একটি project যেকোনো সময় বন্ধও হয়ে যেতে পারে, কারণ কোনো licence-এর শর্ত কাউকে কাজ চালিয়ে যেতে বাধ্য করে না।
E2B compatibility থাকায় এই ঝুঁকি সামলানো সম্ভব। আপনার application এমন একটি protocol-এর সঙ্গে কথা বলে, যার hosted implementation রয়েছে। তাই Dormice-এর development থেমে গেলে দুটি URL পরিবর্তন করেই কাজ চালিয়ে যেতে পারবেন। আপনার agent-কে native API-এর পরিবর্তে E2B surface-এর জন্য লিখুন। এতে প্রয়োজনে অন্য implementation-এ যাওয়ার পথ খোলা থাকবে। Native @dormice/sdk package এখনো npm-এ নেই। সেটি ব্যবহার করতে repository থেকে নিজে build করতে হবে। Compatible path দিয়ে শুরু করার এটি আরেকটি কারণ।
যেখানে host হারালেও সমস্যা সামলাতে পারবেন, সেখানে এটি চালান। Script দিয়ে host পুনর্নির্মাণ করার ব্যবস্থা রাখুন। কোনো prompt বা commit-এ token রাখবেন না। Sandboxes থেকে প্রয়োজনীয় যেকোনো data নিজের backup schedule অনুযায়ী বাইরে সংরক্ষণ করুন।
FAQ
Dormice কি production-এর জন্য প্রস্তুত?
না, এবং project নিজেই তা উল্লেখ করেছে। README-এর status line-এ বলা আছে যে সেখানে কিছুই এখনো production-এর জন্য প্রস্তুত নয়। 12 October 2026 অনুযায়ী repository-টির বয়স প্রায় তিন মাস। এতে কোনো git tag বা release নেই। তাই pin করার মতো কোনো version number নেই। Installer main branch clone করে। এর ফলে প্রতিবার চালালে সর্বশেষ commit পাওয়া যায়। প্রতিটি install-এর পরে git -C /opt/dormice rev-parse HEAD সংরক্ষণ করুন। Installer /var/lib/dormice/backups/-এ যে database snapshot লেখে, তার একটি copy রাখুন। গুরুত্বপূর্ণ সবকিছু sandbox-এর বাইরে রাখুন।
আমার agent-কে একটি disposable VM দেওয়ার সঙ্গে Dormice-এর পার্থক্য কী?
Disposable VM হলো SSH-সহ একটি machine, যা আপনি একটি session-এর জন্য তৈরি করে পরে delete করেন। Dormice হলো একটি execution API। আপনার program প্রথমে acquire এবং পরে exec call করে। এটি মাঝখানে কোনো shell session ছাড়াই stdout এবং exit code ফেরত দেয়। যে human বা agent কিছু সময়ের জন্য একটি সম্পূর্ণ computer চায়, তার জন্য VM উপযোগী। যে application দিনে বহুবার generated code চালায় এবং প্রতিটি run-এর জন্য machine-সমতুল্য setup ও teardown চায় না, তার জন্য Dormice উপযোগী।
Official E2B SDK কি সত্যিই code পরিবর্তন ছাড়া কাজ করে?
হ্যাঁ, তবে configuration পরিবর্তন করতে হবে। apiUrl এবং sandboxUrl-কে আপনার daemon-এর /e2b/api এবং /e2b/envd-এর দিকে নির্দেশ করুন। API key হিসেবে e2b_ prefix-সহ আপনার Dormice token দিন। Official package ব্যবহার করে project-এর end-to-end suite-এর মাধ্যমে command execution, PTY session, file transfer, signed URL এবং port proxy—সবই পরীক্ষা করা হয়েছে। Template building হলো উল্লেখযোগ্য সীমাবদ্ধতা। e2b template build implement করা হয়নি। তাই template হলো এমন একটি docker image, যা আপনি build করে dor template add-এ register করেন।
4 GB VPS-এ কতগুলো sandbox চালু রাখা যায়?
প্রতিটি sandbox 512 MiB ব্যবহার করলে একই সময়ে প্রায় 6টি sandbox চালু রাখা যায়। প্রতিটি sandbox সম্পূর্ণ 1 gibibyte ব্যবহার করলে প্রায় 3টি রাখা যায়। এই হিসাবে operating system, Docker এবং daemon-এর জন্য আনুমানিক 1 GB সংরক্ষণ করা হয়েছে। Frozen sandbox-এর সীমা swap-এর ওপর নির্ভর করে। Installer-এর default 16 GB swapfile ব্যবহার করলে, প্রতিটি sandbox 1 gibibyte memory ধরে রাখার অবস্থায় প্রায় 16টি sandbox রাখা যায়। বাস্তব load-এ free -m ব্যবহার করে নিজের পরিবেশে মাপুন। কারণ test suite চালানো একটি sandbox ছোট script চালানো sandbox-এর তুলনায় কয়েক গুণ বেশি memory ব্যবহার করতে পারে।
Dormice-এর vm.swappiness 100 সেট করা দরকার কেন?
কোনো sandbox freeze করার অর্থ হলো তার idle memory swap-এ স্থানান্তর করা। gVisor sandbox memory shared memory হিসেবে ধরে রাখে। Default swappiness-এ Linux kernel shared memory swap করে না। তাই default মানে freeze করলে কোনো memory reclaim হয় না এবং sandbox পূর্ণ memory ব্যবহার করতে থাকে। Project-এর পরিমাপে default মানে 0 bytes reclaim হয়েছিল। 100 মানে 99.5 percent reclaim হয়েছিল। Configuration file পড়ার পরিবর্তে sysctl vm.swappiness দিয়ে effective value পরীক্ষা করুন। কারণ কিছু cloud image-এ value 0 সেট করা থাকে।