AFFiNE स्वतः होस्ट करा: Notion-सदृश workspace
Docker Compose वापरून AFFiNE एकाच VPS वर चालवा. चार containers, pinned image tags, data कुठे साठतो, backups आणि 2 GB RAM ची प्रत्यक्ष मर्यादा जाणून घ्या.
स्वतः AFFiNE होस्ट केल्यावर काय मिळते
स्वतः AFFiNE होस्ट केल्यावर तुम्ही नियंत्रित करत असलेल्या सर्व्हरवर Notion-शैलीचे workspace मिळते. ते चार containers म्हणून चालते: application, one-shot migration job, Postgres आणि Redis. Real-time collaboration समाविष्ट आहे. Self-hosted workspace ला default म्हणून मिळणाऱ्या 10 seats पर्यंत ही सुविधा उपलब्ध असते. Installation साठी एक compose file आणि एक JSON config file आवश्यक असते. Image tags, disk layout, memory ceiling आणि समोर ठेवलेला proxy यांचा विचार करणे आवश्यक आहे.
AFFiNE मध्ये document editor आणि infinite canvas एकाच workspace मध्ये असतात. त्यामुळे एकाच page कडे document म्हणून वाचता येते किंवा whiteboard प्रमाणे विस्तारता येते. तुम्ही अजून कोणते software चालवायचे हे ठरवत असाल, तर आधी self-hosted Notion पर्यायांची तुलना वाचा. हा मार्गदर्शक निवड झाल्याचे गृहीत धरतो. त्यामुळे पुन्हा तुलना करण्याऐवजी AFFiNE योग्य पद्धतीने चालवण्यावर तो भर देतो.
येथील सर्व माहिती AFFiNE च्या self-host documentation आणि 8 August 2026 रोजी प्रकाशित केलेल्या release files यांच्या आधारे तपासली आहे. त्या तारखेला नवीनतम stable release 0.27.3 होती. ती 23 July 2026 रोजी प्रकाशित झाली होती. त्यानंतरची तारीख असलेले खालील दावे 12 October 2026 रोजी त्यांच्या primary sources विरुद्ध पुन्हा तपासले गेले. त्या वेळी नवीनतम stable release 0.27.4 होती. ती 18 August 2026 रोजी प्रकाशित झाली होती.
चार कंटेनर प्रत्यक्षात काय करतात
affine हे एकाच image मधील server आणि web client आहे. ते port 3010 वर listening करते.
affine_migration हे one-shot job आहे. ते node ./scripts/self-host-predeploy.js चालवते, database migrations लागू करते आणि नंतर बंद होते. Application या job वर condition: service_completed_successfully घोषित करते. त्यामुळे migration non-zero status ने बंद झाल्यास affine मुळीच सुरू होत नाही. Web interface सुरू होत नसल्यास सर्वप्रथम त्या job चे log वाचा.
postgres मध्ये तुमचे documents, users, workspaces आणि permissions साठवले जातात. वितरित केलेले image pgvector/pgvector:pg16 आहे. त्यात pgvector extension समाविष्ट केलेले सामान्य Postgres 16 आहे. pgvector Postgres मध्ये vector column type जोडते. हा embeddings साठवण्यासाठी वापरला जाणारा numeric प्रकार आहे. त्यामुळे मजकूराच्या अर्थानुसार search करता येतो.
redis ही hard dependency आहे. Server आणि migration job दोन्ही सुरू होण्यापूर्वी तिच्या health check ची प्रतीक्षा करतात. वितरित केलेली compose file Redis ला काय देत नाही, हे लक्षात घ्या: volume. docker compose down नंतर त्यातील काहीही टिकत नाही. यावरून स्पष्ट होते की त्यात तुमचा कोणताही content साठवलेला नाही आणि त्याचा backup आवश्यक नाही.
Postgres image pgvector का आहे आणि stock postgres का नाही
ही आवश्यकता AFFiNE च्या schema मधून येते; ती कोणत्याही पसंतीमुळे नाही. v0.27.4 मध्ये schema.prisma अजूनही extensions = [pgvector(map: "vector")] घोषित करतो, परंतु त्यात embedding columns नाहीत. v0.27.3 मध्ये vector(1024) प्रकारचे embedding columns असलेले चार models v0.27.4 मध्ये नाहीत. दिलेली pgvector/pgvector:pg16 image वापरा: extension अजूनही घोषित केलेले आहे आणि stock postgres:16 मध्ये ते समाविष्ट नाही.
अधिकृत v0.27.4 template मध्ये pgvector image वापरली आहे; v0.21.0 template मध्ये अजूनही postgres:16 वापरले जात होते. जुन्या install वर image line संपादित करणे हा संपूर्ण upgrade नाही. त्यामुळे काहीही pull करण्यापूर्वी AFFiNE self-host docs मधील upgrade page वाचा.
त्या tag बाबत आणखी एक महत्त्वाची गोष्ट आहे. pg16 म्हणजे Postgres 16. Postgres ची major version ही थेट वाढवता येणारी संख्या नाही. विद्यमान data directory वर ती pg17 मध्ये बदलल्यास Postgres सुरू होण्यास नकार देतो. docker compose logs postgres मध्ये The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17 सारखी line दिसते. Major version बदलण्यासाठी PostgreSQL 17 release notes मध्ये नमूद केलेल्या तीनपैकी एक मार्ग वापरावा: fresh data directory मध्ये dump आणि restore, pg_upgrade, किंवा logical replication. Single Compose install मध्ये dump आणि restore सहसा सर्वात सोपा मार्ग असतो, कारण pg_upgrade साठी जुन्या आणि नवीन server binaries एकाच वेळी उपलब्ध असणे आवश्यक आहे.
self-hosted AFFiNE साठी किती CPU आणि RAM आवश्यक आहे
AFFiNE च्या requirements पेजनुसार किमान 4 CPU cores आणि 2 GB RAM आवश्यक आहे. तुमच्या documents मध्ये 10,000 words पेक्षा जास्त मजकूर झाल्यावर memory ची गरज 4 GB पर्यंत वाढते. Memory कुठे वापरली जाते हेही त्याच पेजवर स्पष्ट केले आहे: sync system आणि document merging. लक्षात ठेवण्यासारखा एक आकडा दिला आहे: 10,000 modifications असलेला document merge करताना memory वापर 1 GB पर्यंत वाढू शकतो.
आता दोन जण लेखन करत असलेल्या 2 GB plan च्या संदर्भात हे पाहा. सरासरी वापरात समस्या येत नाही. Postgres आणि Node process memory limit च्या आत राहतात आणि काही memory शिल्लक राहते. समस्या peak वापरात आहे. एक मोठा merge server चा memory वापर सुमारे 1 GB च्या peak पर्यंत नेऊ शकतो. 2 GB च्या box वर swap नसल्यास, त्या peak मध्ये Postgres आणि memory मध्ये resident असलेली इतर सर्व माहिती जोडल्यावर memory संपू शकते. त्यानंतर kernel चा out-of-memory (OOM) killer memory मोकळी करण्यासाठी एखादा process बंद करतो. AFFiNE server हा सर्वात मोठा process असल्यामुळे तोच बहुधा बंद होतो. मात्र Docker च्या documentation नुसार Docker स्वतःसह कोणताही process निवडला जाऊ शकतो.
AFFiNE server बंद झाल्यास तुमच्या सहकाऱ्याला error दिसत नाही. पेज पुन्हा load होते, कारण restart: unless-stopped काही सेकंदांत container पुन्हा सुरू करते. याचा अंदाज लावू नका; याची खात्री करा:
docker inspect affine_server --format '{{.State.OOMKilled}} {{.RestartCount}}'
sudo dmesg -T | grep -i -E 'out of memory|killed process'पहिल्या command मधील true किंवा दुसऱ्या command मधील Killed process line मध्ये node चे नाव दिसत असल्यास, bug सापडलेला नसून memory संपली आहे. दोन्ही बाजूंनी उपाय करा. प्रथम swap जोडा, जेणेकरून OOM killer कार्य करण्यापूर्वी memory मधील अचानक वाढ swap मध्ये जाऊ शकेल:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
free -hfree -h ने आता 2.0Gi swap total दाखवले पाहिजे. Swap मुळे AFFiNE वेगवान होत नाही आणि त्याचा उद्देशही तो नाही. अचानक झालेल्या memory वाढीसाठी ते तात्पुरती जागा देते. त्यामुळे container बंद होण्याऐवजी काही काळासाठी कामाचा वेग कमी होण्याची शक्यता वाढते. Swap हा buffer आहे, हमी नाही. उपायाचा दुसरा भाग म्हणजे merge च्या वेळी application ला आवश्यक असलेल्या memory मध्ये Postgres चा cache वाढू न देणे. यासाठी Compose service वरील memory limits वापरता येतात. दोन्ही उपाय केल्यानंतरही process बंद होत असतील, तर मोठ्या documents साठी AFFiNE च्या requirements पेजवर नमूद केलेली 4 GB RAM आवश्यक आहे.
Storage चा अंदाज लावणे खूप सोपे आहे. AFFiNE त्याच पेजवर पुढील आकडे देते:
या तक्त्यामागील डेटा
[
{
"label": "Server install",
"gb": 1.5
},
{
"label": "Postgres per 1,000 docs",
"gb": 0.1
},
{
"label": "Blob store per 1,000 uploads",
"gb": 10
}
]Server install साठी 1.5 GB जागा लागते. प्रत्येकी सुमारे 1,000 words असलेले 1,000 documents Postgres data मध्ये 0.1 GB वाढ करतात. ही वाढ जवळजवळ नगण्य आहे. 1,000 uploaded files साठी 10 GB जागा लागते आणि मुख्य परिणाम याचाच असतो. हे चालू instance मधून घेतलेले मोजमाप नसून AFFiNE ने प्रकाशित केलेले planning figures आहेत. त्यामुळे त्यांना अचूक हमी न मानता वापराचा नमुना समजा. महत्त्वाचा नमुना असा आहे: तुमचा database लहान राहतो आणि तुमच्या uploads मुळे disk ची गरज ठरते.
स्वतः Compose फाइल लिहा आणि tags pin करा
दस्तऐवजीकरणातील install प्रक्रियेत curl -L -o docker-compose.yml https://github.com/toeverything/AFFiNE/releases/latest/download/docker-compose.yml वापरून तयार फाइल डाउनलोड केली जाते. ती कार्य करते. मात्र तिच्यावर अवलंबून राहण्यापूर्वी एक तपशील जाणून घेणे उपयुक्त आहे: 8 August 2026 रोजी release 0.27.3 शी जोडलेल्या फाइलमध्ये paths अजूनही .env फाइलमधून वाचले जात होते. त्यासाठी ${UPLOAD_LOCATION}, ${CONFIG_LOCATION} आणि ${DB_DATA_LOCATION} वापरले जात होते. त्याच वेळी, दस्तऐवजीकरणाच्या reference page वर storage आणि PostgreSQL data ./data अंतर्गत ठेवणारी, configuration ./config अंतर्गत ठेवणारी आणि .env ची गरज नसलेली नवीन layout दाखवली होती. Release 0.27.4 मध्ये जोडलेली फाइल त्या layout वर हलवण्यात आली. 12 October 2026 रोजी दोन्ही layout एकसारख्या आहेत. तुम्ही जुनी फाइल वापरून install केले असल्यास, तुमचे paths अजूनही .env मधून येतात. AFFiNE च्या upgrade page नुसार, ही settings पुढे न नेता compose file बदलल्यास Postgres रिकाम्या data directory सह सुरू होऊ शकतो. फाइल स्वतः लिहिल्यास हा प्रश्न पूर्णपणे टाळता येतो. Images pin करण्यासाठी आणि database password सेट करण्यासाठी तुम्हाला ती फाइल संपादित करावीच लागेल.
mkdir -p ~/affine/config ~/affine/data
cd ~/affine
printf 'DB_PASSWORD=%s\n' "$(openssl rand -hex 24)" > .env
chmod 600 .envCompose project directory मधून .env स्वतः वाचतो आणि तुमच्यासाठी ${DB_PASSWORD} substitute करतो. त्यामुळे support thread मध्ये paste करावयाच्या फाइलमध्ये password दिसत नाही. तुम्ही चालवत असलेल्या प्रत्येक stack मध्ये ही पद्धत वापरणे योग्य आहे. यामागील कारण compose file मधून secrets बाहेर ठेवणे येथे दिले आहे.
आता ~/affine/docker-compose.yml लिहा:
name: affine
services:
affine:
image: ghcr.io/toeverything/affine:stable
container_name: affine_server
ports:
- '127.0.0.1:3010:3010'
depends_on:
redis:
condition: service_healthy
postgres:
condition: service_healthy
affine_migration:
condition: service_completed_successfully
volumes:
- ./data/storage:/root/.affine/storage
- ./config:/root/.affine/config
environment:
- REDIS_SERVER_HOST=redis
- DATABASE_URL=postgresql://affine:${DB_PASSWORD}@postgres:5432/affine
- AFFINE_INDEXER_ENABLED=false
restart: unless-stopped
affine_migration:
image: ghcr.io/toeverything/affine:stable
container_name: affine_migration_job
command: ['sh', '-c', 'node ./scripts/self-host-predeploy.js']
volumes:
- ./data/storage:/root/.affine/storage
- ./config:/root/.affine/config
environment:
- REDIS_SERVER_HOST=redis
- DATABASE_URL=postgresql://affine:${DB_PASSWORD}@postgres:5432/affine
- AFFINE_INDEXER_ENABLED=false
depends_on:
postgres:
condition: service_healthy
redis:
condition: service_healthy
redis:
image: redis:8-alpine
container_name: affine_redis
healthcheck:
test: ['CMD', 'redis-cli', '--raw', 'incr', 'ping']
interval: 10s
timeout: 5s
retries: 5
restart: unless-stopped
postgres:
image: pgvector/pgvector:pg16
container_name: affine_postgres
volumes:
- ./data/postgres:/var/lib/postgresql/data
environment:
POSTGRES_USER: affine
POSTGRES_PASSWORD: ${DB_PASSWORD}
POSTGRES_DB: affine
POSTGRES_INITDB_ARGS: '--data-checksums'
healthcheck:
test: ['CMD', 'pg_isready', '-U', 'affine', '-d', 'affine']
interval: 10s
timeout: 5s
retries: 5
restart: unless-stoppedUpstream कडून दिलेल्या फाइलच्या तुलनेत येथे चार फरक आहेत. प्रत्येक फरकामागे एक कारण आहे.
127.0.0.1:3010:3010port फक्त loopback address वर publish करतो. Docker 28.0.0 पूर्वीच्या versions मध्ये त्याच L2 segment वरील hosts localhost-published ports पर्यंत पोहोचू शकतात. Configured direct routing मुळे loopback publishing असूनही container port बाहेरून उपलब्ध होऊ शकतो. Docker 28.0.0 किंवा त्यानंतरची आवृत्ती वापरा आणि setup दरम्यान direct routing disabled ठेवा. Upstream मधील'3010:3010'प्रत्येक interface वर bind करतो. बहुतेक VPS images मध्ये त्यात public interface देखील समाविष्ट असतो.POSTGRES_HOST_AUTH_METHOD: trustकाढून टाकले आहे आणि त्याऐवजी password सेट केला आहे. Trust authentication वापरल्यास password न देता त्या database शी होणारे कोणतेही connectionaffineuser म्हणून स्वीकारले जाते. हे private Compose network पुरते मर्यादित आहे. मात्र त्या network ला आणखी एक container जोडल्यास किंवा debugging दरम्यान 5432 publish केल्यास ही मर्यादा पुरेशी राहणार नाही.redis:8-alpineऐवजी bareredisवापरलेले नाही; त्याऐवजी तेlatestवर resolve होते. August 2026 नुसार ते Redis 8 आहे. त्यामुळे तुम्ही तपासलेली major version pin राहते आणि असंबंधितdocker compose pullदरम्यान भविष्यात Redis 9 install होण्यापासून प्रतिबंध होतो.pgvector/pgvector:pg16upstream मध्ये जसे सेट केले आहे तसेच ठेवले आहे. त्याचे कारण वर दिले आहे.
Postgres प्रथमच data directory तयार करताना POSTGRES_PASSWORD फक्त एकदाच वाचतो. Instance आधीच अस्तित्वात असल्यास docker compose exec postgres psql -U affine -c "ALTER USER affine WITH PASSWORD 'yourpassword'" वापरून password सेट करा आणि त्यानंतर DATABASE_URL मध्येही तोच password अपडेट करा.
Configuration config/config.json मध्ये असते
AFFiNE आपली settings config/config.json मधून वाचते. ही directory तुम्ही /root/.affine/config वर mount केली आहे. ही file आपोआप तयार केली जात नाही. त्यामुळे पहिल्यांदा सुरू करण्यापूर्वी ती तयार करा. Editor मध्ये ~/affine/config/config.json उघडा आणि उदाहरणातील domain ऐवजी तुमचा स्वतःचा domain देऊन पुढील content लिहा:
{
"$schema": "https://github.com/toeverything/affine/releases/latest/download/config.schema.json",
"server": {
"name": "Team workspace",
"externalUrl": "https://affine.example.com"
},
"copilot": {
"enabled": false,
"byok": {
"enabled": false
}
}
}server.externalUrl हा तुमचे users browser मध्ये प्रत्यक्ष उघडतात तो address असला पाहिजे. AFFiNE share links आणि workspace invitations तयार करताना हे value वापरते. त्यामुळे ते http://localhost:3010 वरच राहिल्यास, तुम्ही पाठवलेले invitation प्राप्तकर्त्याच्याच machine कडे निर्देश करेल आणि तिथे fail होईल. पहिल्यांदा सुरू करण्यापूर्वी ते public HTTPS address वर set करा. त्यामुळे file आणि admin panel मध्ये या address बाबत विसंगती राहणार नाही. नंतर admin panel मध्ये बदललेल्या settings database मध्ये save होतात; त्या या file मध्ये परत लिहिल्या जात नाहीत.
copilot AI features नियंत्रित करते. copilot.byok.enabled हा bring-your-own-key switch आहे. त्यामुळे workspace owner workspace settings मध्ये स्वतःच्या model provider ची key paste करू शकतो. AFFiNE self-host केल्याने AI subscription समाविष्ट होत नाही. तुम्हाला हे feature नको असल्यास दोन्ही false ठेवा.
Stack सुरू करा:
docker compose up -d
docker compose ps --alldocker compose ps --all मध्ये affine_postgres आणि affine_redis healthy, affine_server running, तसेच affine_migration_job ची state exited (0) असल्याचे दिसले पाहिजे. --all महत्त्वाचे आहे. त्याशिवाय docker compose ps मध्ये फक्त running containers दिसतात. त्यामुळे यशस्वीरीत्या पूर्ण झालेले migration job अजिबात दिसत नाही. Migration job साठी इतर कोणताही exit code आल्यास त्याचा तपास करा. त्याच्या log मध्ये थांबलेली step नमूद असते:
docker compose logs affine_migrationतुम्ही विसरण्यापूर्वी image pin करा
stable हा बदलणारा tag आहे. AFFiNE च्या release workflow मध्ये प्रत्येक stable build साठी अनेक tags दिले जातात. त्यापैकी येथे दोन tags महत्त्वाचे आहेत: stable, जो प्रत्येक release वेळी पुन्हा निर्देशित केला जातो, आणि git short hash नंतरचा stable-, जो बदलला जात नाही. stable वर ठेवले असल्यास, सहा महिन्यांनंतरचा docker compose pull वेगळी image fetch करेल आणि तुम्ही ठरवले नसलेल्या वेळी तिचे migrations तुमच्या database वर चालवेल. तुम्ही तपासलेली अचूक image pin करा:
docker compose pull
docker image inspect ghcr.io/toeverything/affine:stable --format '{{index .RepoDigests 0}}'यामुळे ghcr.io/toeverything/affine@sha256: नंतरचा लांब hash असलेली ओळ दिसते. हा पूर्ण string affine आणि affine_migration या दोन्हींच्या image: line मध्ये paste करा. हे दोन्ही नेहमी जुळले पाहिजेत, कारण तीच image दोन भूमिका बजावते. Mismatch असल्यास database एका schema वर migrate होतो, पण सेवा दुसऱ्या schema सह चालते. त्यानंतर upgrade हा अनपेक्षित बदल न राहता जाणीवपूर्वक केलेला edit ठरतो: digest बदला, backup घ्या, docker compose pull, docker compose up -d.
इतर कोणीही करण्यापूर्वी admin खाते तयार करा
नवीन instance वर /admin उघडल्यास AFFiNE तुम्हाला खाते तयार करण्याच्या पृष्ठावर पाठवते, कारण सर्व्हरवर अद्याप administrator नाही. या प्रक्रियेत invitation code किंवा setup token नसतो. नोंदणी पूर्ण करणारी पहिली व्यक्ती तुमच्या सर्व्हरची administrator बनते. त्यामुळे तुम्ही नोंदणी करेपर्यंत हा पोर्ट बंद ठेवला पाहिजे.
म्हणूनच वरील compose file 127.0.0.1 शी bind करते. तुमच्या स्वतःच्या मशीनवरून SSH tunnel द्वारे त्यावर प्रवेश करा:
ssh -L 3010:127.0.0.1:3010 you@your-server-ipही प्रक्रिया चालू ठेवा आणि तुमच्या स्थानिक browser मध्ये http://127.0.0.1:3010/admin उघडा. नोंदणी करून log in करा आणि त्यानंतर tunnel बंद करा. आता instance ला public name देणे सुरक्षित आहे. इतर self-hosted अॅप्समध्येही अशीच race condition असते. पहिल्या login वेळी hostname शी जोडलेला passkey तयार होत असल्यास हा धोका अधिक गंभीर असतो. म्हणून पहिल्या खात्यापूर्वी TLS आणि अंतिम domain निश्चित करणे आवश्यक आहे, जेव्हा तुम्ही self-host openGym करता.
AFFiNE तुमचा डेटा कुठे ठेवते
तीन path मध्ये सर्व डेटा साठवला जातो आणि हे तिन्ही path तुम्ही तयार केलेल्या directory मध्येच आहेत.
./data/postgresही Postgres data directory आहे. येथे documents, users, workspaces, permissions आणि admin panel मधून जतन केलेल्या server settings साठवल्या जातात../data/storageही container मधील/root/.affine/storageयेथे mount केली जाते आणि त्यात upload केलेल्या सर्व files साठवल्या जातात../configही/root/.affine/configयेथे mount केली जाते आणि त्यात migration job ने तयार केलेलेconfig.jsonआणिprivate.keyसाठवले जातात.
येथे upstream configuration मध्ये named volumes ऐवजी bind mounts वापरले आहेत आणि हा निर्णय जाणीवपूर्वक घेतलेला आहे. त्यामुळे Docker ने हे paths कुठे ठेवले आहेत हे शोधण्याची गरज नसते; सामान्य commands वापरून तुम्ही त्यांचा tar archive तयार करून copy करू शकता. मात्र host वरील file ownership ची जबाबदारी आता तुमची असते. हा bind mounts आणि named volumes यांमधील trade-off आहे, ज्याचा उल्लेख bind mounts आणि named volumes येथे केला आहे.
AFFiNE चा बॅकअप कसा घ्यावा
दोन गोष्टींचा बॅकअप घ्यावा लागतो आणि त्यांची पद्धत वेगळी असते. डेटाबेस live server असल्यामुळे तो चालू असताना त्याच्या फाइल्स कॉपी केल्यास corrupt copy तयार होते. त्याऐवजी dump घ्या:
mkdir -p ~/affine/backup
cd ~/affine
docker compose exec -T postgres pg_dump --format c --username affine affine \
> backup/affine-$(date +%F).dump
ls -lh backup/हा dump container मध्ये त्याच्या local socket वर चालतो. त्यामुळे password विचारला जात नाही. त्या ls output मध्ये size तपासा. काहीशे bytes असलेल्या फाइलचा अर्थ dump अयशस्वी झाला, पण shell ने फाइल तयार केली. ही चूक सहा महिन्यांनी लक्षात येते. -T देखील महत्त्वाचे आहे. ते नसल्यास Compose terminal allocate करू शकते आणि binary stream corrupt होऊ शकतो.
Uploaded files या साध्या files आहेत. त्यामुळे त्यांचे tar archive तयार करा:
tar czf backup/storage-$(date +%F).tgz -C data storage
tar czf backup/config-$(date +%F).tgz config docker-compose.yml .envसंपूर्ण config directory, Compose file आणि .env तुमच्या backup मध्ये ठेवा. Dump मध्ये या गोष्टी समाविष्ट नसतात. Migration job config/private.key देखील तयार करते. त्यामुळे फक्त config.json कॉपी केल्यास ती फाइल backup मध्ये राहणार नाही. Admin panel मध्ये जतन केलेली settings database मध्ये असतात. त्यामुळे वरील dump मध्ये त्या आधीच समाविष्ट होतात. तसेच, 12 October 2026 पासून AFFiNE च्या backup page नुसार, बदललेल्या server settings admin panel मधून export करता येतात. या तिन्ही files serverच्या बाहेर कॉपी करा. ज्या disk वर संरक्षित data आहे त्याच disk वर ठेवलेला backup हा backup मानला जात नाही. Database dump आणि uploads directory चे tar archive अशी ही विभागलेली पद्धत तुम्ही चालवणाऱ्या प्रत्येक इतर stateful container साठी वापरा. Support desk म्हणून Chatwoot self-host करताना conversation history आणि attachments सुरक्षित ठेवण्यासाठीही हीच पद्धत वापरता येते.
पुनर्संचयित करणे आणि प्रकाशित चरणांमधील एक सापळा
गरज भासण्यापूर्वीच अधिकृत restore चरण वाचा आणि ते काळजीपूर्वक तपासा. August 2026 मध्ये प्रकाशित केलेल्या चरणांमध्ये affine.backup नावाची file container मध्ये copy केली जात होती आणि त्यानंतर ./pg.backup मधून restore केले जात होते. ही दोन वेगवेगळी नावे आहेत. तसेच त्यांनी ./postgres directory काढून टाकली होती, पण सध्याची compose file तिचा data ./data/postgres मध्ये ठेवते. 12 October 2026 रोजी page वर सर्वत्र affine.backup वापरले आहे आणि restore पडताळले जाईपर्यंत जुनी Postgres directory ठेवण्यास सांगितले आहे. त्यामुळे upstream मध्ये हा सापळा दुरुस्त झाला आहे. मात्र त्यापूर्वी जतन केलेल्या चरणांच्या copy मध्ये तो अजूनही असू शकतो. कोणत्याही snippet मधील paths वापरण्याऐवजी तुम्ही प्रत्यक्ष वापरलेले paths वापरा. या guide मधील layout साठी sequence पुढीलप्रमाणे आहे:
cd ~/affine
docker compose down
sudo mv data/postgres data/postgres.old
docker compose up -d postgres
docker compose cp backup/affine-2026-08-08.dump postgres:/tmp/affine.dump
docker compose exec postgres pg_restore --format c --username affine \
--dbname affine --verbose /tmp/affine.dump
docker compose up -drm ऐवजी mv वापरल्याचे लक्षात ठेवा. ज्याची copy ठेवलेली नाही अशा database वर restore केल्यास एका चुकीच्या command मुळे संपूर्ण data loss होऊ शकतो. जुनी directory बाजूला हलवण्यासाठी कोणताही खर्च येत नाही. tar xzf backup/storage-2026-08-08.tgz -C data वापरून uploads देखील restore करा. अन्यथा प्रत्येक document मध्ये attachments तुटलेले दिसतील. त्यानंतर login करा आणि image असलेले document उघडा. हीच चाचणी आहे. Browser मध्ये उघडून तपासलेले नसलेले restore म्हणजे backup नव्हे, तर केवळ एक file आहे.
तुम्ही आधीपासून चालवत असलेल्या proxy मागे AFFiNE ठेवणे
AFFiNE WebSocket वापरते आणि ते ऐच्छिक नाही. AFFiNE ची sync आणि collaboration system WebSocket वर आधारित आहे. त्यामुळे WebSocket connections upgrade न करणाऱ्या proxy मुळे editing quietly sync होणे थांबते. पेज load होते आणि login कार्य करते; पण एका browser मध्ये केलेला edit दुसऱ्या browser पर्यंत पोहोचत नाही. तुमच्या browser च्या developer tools मध्ये Network tab उघडा आणि WS वर filter करा. वारंवार उघडणारे आणि बंद होणारे connection म्हणजे proxy upgrade पुढे पाठवत नाही याचे लक्षण आहे.
तुम्ही इतर containers साठी Traefik आधीपासून चालवत असल्यास, AFFiNE ही त्यातील सामान्य service म्हणून जोडता येते. affine service मधील ports: block हटवा आणि पुढील मजकूर जोडा:
networks:
- default
- proxy
labels:
- 'traefik.enable=true'
- 'traefik.docker.network=proxy'
- 'traefik.http.routers.affine.rule=Host(`affine.example.com`)'
- 'traefik.http.routers.affine.entrypoints=websecure'
- 'traefik.http.routers.affine.tls.certresolver=letsencrypt'
- 'traefik.http.services.affine.loadbalancer.server.port=3010'तसेच, file च्या शेवटी services: च्या बाजूला पुढील मजकूर जोडा:
networks:
proxy:
external: trueCertificate resolver चे नाव तुमच्या Traefik configuration मध्ये परिभाषित केलेल्या नावाशी जुळले पाहिजे. loadbalancer.server.port हा container port 3010 आहे; host port नाही. Traefik WebSocket connections साठी अतिरिक्त configuration शिवाय proxy करते. त्यामुळे आणखी काही जोडण्याची गरज नाही. तुमच्या stack मधील इतर सेवा single sign-on साठी Authentik मागे आधीपासून असल्यास, या router वर forward auth middleware लावल्याने AFFiNE साठी browser access नियंत्रित करता येईल. परंतु desktop app ची चाचणी होईपर्यंत ते बंद ठेवा. Desktop app कडे browser session नसते आणि त्यामुळे sync अपयशी ठरते. एका instance मागे अनेक apps चालवण्याची माहिती अनेक apps समोर एकच Traefik येथे दिली आहे.
nginx मध्ये upgrade स्पष्टपणे सांगावे लागते:
location / {
proxy_pass http://127.0.0.1:3010;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $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;
client_max_body_size 100m;
}nginx मध्ये client_max_body_size चे default मूल्य 1 MB असते. त्यामुळे ही line नसल्यास छोट्या photo पेक्षा मोठे प्रत्येक upload 413 status सह अपयशी ठरते. AFFiNE logs मध्ये काहीही दिसत नाही, कारण request तेथे पोहोचलेलीच नसते. Caddy साठी reverse_proxy http://127.0.0.1:3010 ही एक line पुरेशी आहे. Certificates आणि WebSocket upgrades Caddy स्वतः हाताळते.
self-hosted build मध्ये नसलेली वैशिष्ट्ये
टीमचे स्थलांतर करण्यापूर्वी याबाबत स्वतःशी प्रामाणिक रहा.
Real-time collaboration उपलब्ध आहे. Sizing संबंधी सर्व सूचना याच वैशिष्ट्याभोवती आहेत, कारण AFFiNE च्या दस्तऐवजीकरणानुसार memory वापराचे कारण sync system आणि document merging हे आहेत. अनेकांना local-first tool हवे असण्याचे कारण offline editing हे आहे. Desktop application मध्ये तुमचा self-hosted server workspace list मध्ये जोडता येतो आणि त्यावर login करता येतो. तुमच्या टीमला आवश्यक असलेल्या अचूक offline behaviour ची commit करण्यापूर्वी चाचणी करा: network बंद असताना desktop app मध्ये edit करा, पुन्हा connect करा आणि नंतर दुसऱ्या device वर result तपासा. Feature lists हा पुरावा नाहीत. यामध्ये ही यादीही येते.
Shipped compose file मध्ये server-side full-text search बंद आहे. त्या file मध्ये AFFINE_INDEXER_ENABLED=false server वर आणि migration job वर set केलेले आहे. ते सुरू करण्यासाठी Manticore Search container जोडावा लागतो. त्यामुळे पाचवी service आणि अधिक memory लागते. 2 GB box वर हा बदल memory मर्यादा ओलांडण्यास कारणीभूत ठरतो. Client मध्ये search सुरू असलेल्या workspace वर अजूनही कार्य करते.
लोकांना invite करण्यापूर्वी दोन मर्यादा जाणून घेणे आवश्यक आहे. Self-hosted workspace ला जास्तीत जास्त 10 seats दिल्या जातात. त्यापेक्षा अधिक seats साठी AFFiNE कडून Team license आवश्यक आहे. Self-hosted instances साठी unlimited blob storage आणि unlimited blob size अपेक्षित असल्याचे दस्तऐवजीकरणात नमूद आहे; मात्र ते अद्याप पूर्णपणे implemented नाहीत. ही स्थिती October 2026 मध्ये तपासली होती. Household किंवा small team साठी यापैकी कोणतीही मर्यादा महत्त्वाची नाही. मात्र चाळीस लोकांचे स्थलांतर करण्याची योजना असल्यास दोन्ही मर्यादा महत्त्वाच्या ठरतात.
अपग्रेड
प्रथम release notes वाचा. विशेषतः 0.26 ते 0.27 सारखे minor version bump करताना हे महत्त्वाचे आहे, कारण breaking changes त्यात येऊ शकतात. कोणताही बदल करण्यापूर्वी database आणि storage directory चा backup घ्या. पुढील start वेळी migration job तुमच्या schema मध्ये बदल करते आणि तो पूर्ववत करता येत नाही. त्यानंतर pinned digest बदला, docker compose pull चालवा आणि त्यानंतर docker compose up -d चालवा. प्रक्रिया व्यवस्थित पूर्ण होईपर्यंत docker compose logs -f affine_migration वर लक्ष ठेवा. नंतर docker image prune जुने layers काढून टाकते. जुन्या install साठी एक ऐतिहासिक नोंद: version 0.23.0 पासून image name affine-graphql वरून affine असे बदलले. त्यामुळे त्यापूर्वीची compose file वापरत असल्यास pull करताना image सापडण्यासाठी तिच्यातील image lines पुन्हा लिहाव्या लागतील. तसेच version 0.27.4 पासून अधिकृत compose template मधील Postgres, upload आणि configuration paths बदलले आहेत आणि default database connection देखील बदलले आहे. कार्यरत install वर नवीन file थेट कॉपी करण्याऐवजी ती तुमच्या file शी तुलना करा.
FAQ
AFFiNE कंटेनर कधीही सुरू का होत नाही?
affine सेवा affine_migration job वर condition: service_completed_successfully घोषित करते. त्यामुळे migration कोणत्याही 0 व्यतिरिक्त status ने बंद झाल्यास server कधीही सुरू होत नाही आणि web interface अजिबात दिसत नाही. कोणत्या step वर प्रक्रिया थांबली हे पाहण्यासाठी docker compose logs affine_migration चालवा. हाताने संपादित केलेल्या compose file मध्ये अजूनही pgvector/pgvector:pg16 वापरले आहे याची खात्री करा. Stock Postgres मध्ये pgvector extension समाविष्ट नसते. AFFiNE च्या schema मध्ये ती अजूनही घोषित आहे, जरी v0.27.4 मध्ये v0.27.3 मधील चार embedding models आता परिभाषित केलेले नाहीत.
self-hosted AFFiNE साठी किती RAM आवश्यक आहे?
AFFiNE च्या requirements page नुसार किमान 4 CPU cores आणि 2 GB RAM आवश्यक आहे. Documents मध्ये 10,000 words पेक्षा जास्त असल्यास ही गरज 4 GB पर्यंत वाढते. तसेच 10,000 modifications असलेला document merge करताना memory वापर 1 GB पर्यंत वाढू शकतो. 2 GB server वर समस्या idle load मुळे होत नाही. हा peak memory वापर समस्या निर्माण करतो. Kernel out-of-memory killer एखादी process बंद करण्यासाठी निवडतो. सर्वात मोठी process असल्यामुळे ती AFFiNE server असण्याची शक्यता जास्त असते. त्यानंतर restart: unless-stopped ती पुन्हा सुरू करते. त्यामुळे users ना error ऐवजी page reload दिसतो. docker inspect affine_server --format '{{.State.OOMKilled}}' आणि sudo dmesg -T | grep -i 'out of memory' वापरून याची खात्री करा. Short spikes साठी buffer म्हणून 2 GB swap file जोडा. Processes बंद होणे सुरूच राहिल्यास RAM 4 GB पर्यंत वाढवा.
AFFiNE माझा data कुठे साठवते आणि कोणत्या गोष्टींचा backup घ्यावा?
तुमच्या compose directory अंतर्गत तीन paths मध्ये सर्व data असतो: database साठी ./data/postgres, uploaded files साठी ./data/storage आणि config.json तसेच generated private.key साठी ./config. Files copy करण्याऐवजी docker compose exec -T postgres pg_dump --format c --username affine affine > affine.dump वापरून database चा backup घ्या. चालू Postgres ची files सुरक्षितपणे copy करता येत नाहीत. त्या dump मध्ये admin panel मध्ये जतन केलेल्या settings देखील असतात, कारण AFFiNE त्या database मध्ये साठवते. Uploads साठी ./data/storage चे tar archive तयार करा. संपूर्ण config directory, Compose file आणि .env जतन करा, कारण त्या files database चा भाग नाहीत.
self-hosted AFFiNE वर real-time collaboration कार्य करते का?
होय. त्यासाठी काहीही enable करण्याची आवश्यकता नाही. तुमचा reverse proxy योग्य प्रकारे configured असणे ही एकमेव अट आहे, कारण sync WebSocket connections वर चालते. nginx मध्ये यासाठी proxy_http_version 1.1 तसेच Upgrade आणि Connection: upgrade headers आवश्यक असतात. Traefik आणि Caddy हे connections अतिरिक्त configuration शिवाय forward करतात. Proxy ने WebSocket connections upgrade न केल्याचे लक्षण म्हणजे workspace नेहमीप्रमाणे load होते आणि login देखील होते, परंतु एका browser मध्ये केलेले edits दुसऱ्या browser मध्ये दिसत नाहीत.
stock Postgres image सह AFFiNE चालवता येते का?
pgvector/pgvector:pg16 वापरा. त्यामध्ये pgvector extension compile केलेले Postgres 16 आहे. AFFiNE v0.27.4 मध्ये schema.prisma मध्ये extensions = [pgvector(map: "vector")] अजूनही घोषित आहे. परंतु v0.27.3 मध्ये असलेल्या vector(1024) embedding columns सह चार models आता परिभाषित केलेले नाहीत. Stock Postgres मध्ये घोषित extension समाविष्ट नसते. त्याऐवजी AFFiNE ला external Postgres server कडे निर्देशित करत असल्यास, त्या server वर pgvector install करा आणि migration चालवण्यापूर्वी target database मध्ये extension तयार करा.