AFFiNE-ஐ Docker மூலம் self-host செய்வது எப்படி?
Docker Compose பயன்படுத்தி AFFiNE-ஐ உங்கள் server-ல் நிறுவுவதற்கான முழுமையான வழிகாட்டி. நான்கு containers, தரவு சேமிப்பு, 2 GB RAM தேவை மற்றும் backup எடுக்கும் முறையை இதில் அறியலாம்.
AFFiNE-ஐ நீங்களே host செய்யும்போது உங்களுக்குக் கிடைப்பவை
AFFiNE-ஐ நீங்களே host செய்வது, உங்கள் கட்டுப்பாட்டில் உள்ள server-ல் Notion போன்ற ஒரு workspace-ஐ வழங்குகிறது. இது நான்கு containers-ஆக இயங்குகிறது: application, ஒருமுறை மட்டும் இயங்கும் migration job, Postgres, மற்றும் Redis. இதில் real-time collaboration வசதி உள்ளது; நீங்களே host செய்யும் workspace-க்கு இயல்பாகவே 10 seats வரை கிடைக்கும். இதன் நிறுவல் ஒரு compose file மற்றும் ஒரு JSON config file ஆகியவற்றைக் கொண்டது. image tags, disk layout, memory ceiling, மற்றும் முன்னால் நீங்கள் வைக்கும் proxy ஆகியவற்றில் கவனம் செலுத்த வேண்டும்.
AFFiNE ஒரே workspace-ல் document editor மற்றும் infinite canvas ஆகிய இரண்டையும் வைத்திருக்கிறது. எனவே, ஒரு பக்கத்தை document-ஆகப் படிக்கலாம் அல்லது whiteboard-ஆக விரிவுபடுத்தலாம். நீங்கள் எதை இயக்க வேண்டும் என்று இன்னும் முடிவு செய்யவில்லை என்றால், முதலில் self-hosted Notion மாற்றுகளின் ஒப்பீட்டை படிக்கவும். இந்த வழிகாட்டி, நீங்கள் ஏற்கனவே முடிவெடுத்துவிட்டதாகக் கருதி, AFFiNE-ஐ முறையாக இயக்குவது பற்றி மட்டுமே விளக்குகிறது.
இங்குள்ள அனைத்தும் AFFiNE self-host ஆவணங்கள் மற்றும் 8 August 2026 அன்று வெளியிடப்பட்ட release files-உடன் சரிபார்க்கப்பட்டன. அந்தத் தேதியில் இருந்த புதிய stable release 0.27.3 ஆகும், இது 23 July 2026 அன்று வெளியிடப்பட்டது. கீழே உள்ள தகவல்கள், 12 October 2026 அன்று அவற்றின் முதன்மை ஆதாரங்களுடன் மீண்டும் சரிபார்க்கப்பட்டன; அப்போது புதிய stable release 0.27.4 ஆக இருந்தது, இது 18 August 2026 அன்று வெளியிடப்பட்டது.
நான்கு containers-ன் செயல்பாடுகள்
affine என்பது ஒரே image-ல் உள்ள server மற்றும் web client ஆகும். இது port 3010-ல் இயங்குகிறது.
affine_migration என்பது node ./scripts/self-host-predeploy.js-ஐ இயக்கும் ஒரு one-shot பணியாகும்; இது database migrations-ஐ முடித்துவிட்டு வெளியேறிவிடும். அந்தப் பணியின் மீது condition: service_completed_successfully-ஐ application குறிப்பிடுவதால், migration தோல்வியடைந்து (non-zero status) வெளியேறினால், affine தொடங்கவே தொடங்காது. Web interface இயங்கவில்லை என்றால், முதலில் அந்தப் பணியின் log-ஐப் பார்க்க வேண்டும்.
postgres உங்கள் ஆவணங்கள், பயனர்கள், workspaces மற்றும் அனுமதிகளைச் சேமிக்கிறது. வழங்கப்பட்ட image pgvector/pgvector:pg16 ஆகும்; இது pgvector extension சேர்க்கப்பட்ட சாதாரண Postgres 16 ஆகும். pgvector, Postgres-ல் vector column வகையைச் சேர்க்கிறது. இது embeddings-ஐச் சேமிக்கப் பயன்படும் எண் வடிவம்; இதன் மூலம் உரைகளை அவற்றின் பொருளைக் கொண்டு தேட முடியும்.
redis ஒரு கட்டாயத் தேவை (hard dependency): server மற்றும் migration பணி ஆகிய இரண்டுமே, இது இயங்கத் தொடங்கிய பின்னரே செயல்படும். வழங்கப்பட்ட compose file-ல் Redis-க்கு volume வழங்கப்படவில்லை என்பதைக் கவனிக்கவும். இதில் உள்ள எந்தத் தரவும் docker compose down-க்குப் பிறகு இருக்காது. இதிலிருந்து, இதில் உங்கள் தரவுகள் எதுவும் இல்லை என்பதும், இதற்கு backup தேவையில்லை என்பதும் தெளிவாகிறது.
ஏன் Postgres image-க்கு stock postgres-க்கு பதிலாக pgvector பயன்படுத்தப்படுகிறது
இந்தத் தேவை AFFiNE-ன் schema-விலிருந்து வருகிறது, விருப்பத்தின் அடிப்படையில் அல்ல. v0.27.4-ல், schema.prisma இன்னும் extensions = [pgvector(map: "vector")]-ஐ அறிவிக்கிறது, ஆனால் அதில் embedding columns எதுவும் இல்லை. v0.27.3-ல் vector(1024) என்று வகைப்படுத்தப்பட்ட embedding columns கொண்ட நான்கு மாதிரிகள் v0.27.4-ல் இல்லை. வழங்கப்பட்ட pgvector/pgvector:pg16 image-ஐ அப்படியே வைத்திருங்கள்: extension இன்னும் அறிவிக்கப்பட்டே உள்ளது, ஆனால் stock postgres:16-ல் அது இல்லை.
அதிகாரப்பூர்வ v0.27.4 template pgvector image-ஐப் பயன்படுத்துகிறது; v0.21.0 template இன்னும் postgres:16-ஐப் பயன்படுத்தியது. பழைய நிறுவலின் போது, image வரியை மட்டும் மாற்றுவது முழுமையான upgrade ஆகாது, எனவே எதையும் pull செய்வதற்கு முன் AFFiNE self-host docs-ல் உள்ள upgrade பக்கத்தைப் படிக்கவும்.
அந்த 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 போன்ற ஒரு வரியைக் காட்டும். ஒரு major version மாற்றத்திற்கு PostgreSQL 17 release notes-ல் குறிப்பிடப்பட்டுள்ள மூன்று வழிகளில் ஒன்று தேவை: dump செய்து புதிய data directory-ல் restore செய்வது, pg_upgrade, அல்லது logical replication. ஒரு தனி Compose நிறுவலில் dump மற்றும் restore செய்வதே பொதுவாக எளிதானது, ஏனெனில் pg_upgrade-க்கு பழைய மற்றும் புதிய server binaries அருகருகே இருக்க வேண்டும்.
self-hosted AFFiNE-க்கு எவ்வளவு CPU மற்றும் RAM தேவை
AFFiNE-ன் தேவைகள் பக்கத்தில் குறைந்தபட்சம் 4 CPU cores மற்றும் 2 GB RAM தேவை என்று குறிப்பிடப்பட்டுள்ளது. உங்கள் ஆவணங்கள் 10,000 சொற்களைத் தாண்டும்போது, நினைவகத் தேவை 4 GB-ஆக உயர்கிறது. இந்த நினைவகம் எங்கே செலவாகிறது என்பதையும் அதே பக்கம் விளக்குகிறது: sync system மற்றும் document merging. இதில் கவனிக்க வேண்டிய ஒரு முக்கிய புள்ளி: 10,000 மாற்றங்களைக் கொண்ட ஒரு ஆவணத்தை இணைக்கும்போது (merging), அது உச்சகட்டமாக 1 GB நினைவகத்தைப் பயன்படுத்தலாம்.
இப்போது இதை 2 GB திட்டத்தில் இருவர் எழுதும் சூழலுடன் ஒப்பிடுவோம். சராசரி பயன்பாடு சரியாகவே இருக்கும். Postgres மற்றும் Node process ஆகியவை வரம்பிற்குள் இருக்கும், மீதமுள்ள இடமும் போதுமானதாக இருக்கும். ஆனால், உச்சகட்ட பயன்பாடுதான் சிக்கல். ஒரு பெரிய merge நடக்கும்போது, server-ன் நினைவகப் பயன்பாடு 1 GB வரை உயரலாம். swap இல்லாத 2 GB server-ல், இந்த உச்சகட்ட பயன்பாட்டுடன் Postgres மற்றும் பிற process-களும் சேரும்போது நினைவகம் தீர்ந்துவிடும். அப்போது kernel-ன் out-of-memory (OOM) killer, நினைவகத்தை விடுவிக்க ஏதேனும் ஒரு process-ஐக் கொல்லும். AFFiNE server தான் மிகப்பெரிய process என்பதால், அதுவே பெரும்பாலும் பலியாகும். இருப்பினும், Docker-ன் ஆவணங்களின்படி, Docker உட்பட எந்த process-ம் கொல்லப்படலாம் என்று தெளிவாகக் கூறப்பட்டுள்ளது.
AFFiNE server கொல்லப்படும்போது, உங்கள் சக ஊழியருக்குப் பிழை எதுவும் தெரியாது. பக்கம் மீண்டும் reload ஆகும், ஏனெனில் restart: unless-stopped சில நொடிகளில் container-ஐ மீண்டும் இயக்கிவிடும். இதை ஊகிக்க வேண்டாம், உறுதிப்படுத்தவும்:
docker inspect affine_server --format '{{.State.OOMKilled}} {{.RestartCount}}'
sudo dmesg -T | grep -i -E 'out of memory|killed process'முதல் கட்டளையிலிருந்து true அல்லது இரண்டாவது கட்டளையிலிருந்து node-ஐக் குறிப்பிடும் Killed process வரி இருந்தால், நீங்கள் ஒரு bug-ஐக் கண்டறியவில்லை, மாறாக நினைவகம் தீர்ந்துவிட்டது என்று அர்த்தம். இதை இரு முனைகளிலும் சரிசெய்யவும். முதலில் swap-ஐச் சேர்க்கவும், இதனால் OOM killer செயல்படுவதற்கு முன்பு, நினைவகத் தேவை அதிகரிக்கும்போது அதைத் தாங்க ஒரு buffer இருக்கும்:
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 மொத்தமாக இருப்பதைக் காட்ட வேண்டும். Swap, AFFiNE-ஐ வேகப்படுத்தாது, அதற்காக அது உருவாக்கப்படவும் இல்லை. இது ஒரு தற்காலிகத் தேவைக்கான இடத்தைத் தருகிறது, இதனால் container செயலிழப்பதற்குப் பதிலாக ஒரு நொடி தாமதம் ஏற்பட வாய்ப்புள்ளது. இது ஒரு buffer, உத்தரவாதம் அல்ல. அடுத்த கட்டமாக, merge நடக்கும்போது application-க்குத் தேவையான இடத்தை Postgres அதன் cache-க்காக எடுத்துக்கொள்வதைத் தடுக்க வேண்டும். இதற்குத்தான் Compose service-ல் நினைவக வரம்புகள் பயன்படுகின்றன. இவை இரண்டையும் செய்த பிறகும் செயலிழப்புகள் தொடர்ந்தால், பெரிய ஆவணங்களுக்கு AFFiNE-ன் தேவைகள் பக்கத்தில் கோரப்பட்டுள்ள 4 GB நினைவகம் server-க்குத் தேவைப்படும்.
சேமிப்பகத்தை (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 நிறுவல் 1.5 GB-ஐ எடுத்துக்கொள்ளும். தலா ஆயிரம் சொற்களைக் கொண்ட ஆயிரம் ஆவணங்கள் 0.1 GB Postgres தரவைச் சேர்க்கும், இது மிகக் குறைவு. ஆயிரம் கோப்புகளைப் பதிவேற்றினால் 10 GB சேரும், இதுவே முக்கியமானது. இவை இயங்கும் instance-லிருந்து எடுக்கப்பட்ட அளவீடுகள் அல்ல, திட்டமிடலுக்காக வெளியிடப்பட்ட புள்ளிவிவரங்கள். எனவே, இவற்றை ஒரு தோராயமான அளவீடாகக் கருதவும், உறுதியான வாக்குறுதியாக அல்ல. தரவுத்தளம் சிறியதாகவே இருக்கும், உங்கள் பதிவேற்றங்களே வட்டு இடத்தைத் தீர்மானிக்கும் என்பதுதான் இதில் முக்கியமானது.
Compose கோப்பை நீங்களே எழுதுங்கள், tags-ஐ உறுதிப்படுத்துங்கள்
ஆவணப்படுத்தப்பட்ட நிறுவல் முறை curl -L -o docker-compose.yml https://github.com/toeverything/AFFiNE/releases/latest/download/docker-compose.yml மூலம் ஏற்கனவே தயாரிக்கப்பட்ட கோப்பைத் தரவிறக்கம் செய்கிறது. அது வேலை செய்யும். ஆனால், அதை நம்புவதற்கு முன் ஒரு விவரத்தை அறிவது அவசியம்: 8 ஆகஸ்ட் 2026 நிலவரப்படி, release 0.27.3-ல் இணைக்கப்பட்ட கோப்பு அதன் பாதைகளை .env கோப்பிலிருந்து ${UPLOAD_LOCATION}, ${CONFIG_LOCATION} மற்றும் ${DB_DATA_LOCATION} ஆகியவற்றைப் பயன்படுத்திப் படித்தது. அதே சமயம், ஆவணங்களின் reference பக்கம் புதிய அமைப்பைக் காட்டியது; அது storage மற்றும் PostgreSQL தரவுகளை ./data-க்குக் கீழே வைத்து, configuration-ஐ ./config-ல் வைத்திருந்தது, மேலும் அதற்கு .env தேவையில்லை. Release 0.27.4 அந்த அமைப்பிற்கு மாறியது, 12 அக்டோபர் 2026 நிலவரப்படி இரண்டும் ஒத்துப்போகின்றன. நீங்கள் பழைய கோப்பிலிருந்து நிறுவியிருந்தால், உங்கள் பாதைகள் இன்னும் .env-லிருந்துதான் வரும். அந்த அமைப்புகளை மாற்றாமல் compose கோப்பை மாற்றினால், Postgres காலியான தரவு அடைவுடன் (data directory) தொடங்கும் என்று AFFiNE-ன் upgrade பக்கம் எச்சரிக்கிறது. கோப்பை நீங்களே எழுதுவது இந்தச் சிக்கலை முழுமையாகத் தவிர்க்கிறது; மேலும், 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}-ஐ உங்களுக்குப் பதிலீடு செய்கிறது. எனவே, நீங்கள் support thread-ல் பகிரும் கோப்பில் கடவுச்சொல் ஒருபோதும் இடம்பெறாது. நீங்கள் இயக்கும் ஒவ்வொரு stack-லும் இந்த வழக்கத்தைப் பின்பற்றுவது நல்லது. இதற்கான காரணம் keeping secrets out of the compose file பகுதியில் உள்ளது.
இப்போது ~/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:3010, port-ஐ loopback முகவரியில் மட்டுமே வெளியிடுகிறது. 28.0.0-க்கு முந்தைய Docker பதிப்புகள், ஒரே L2 segment-ல் உள்ள hosts, localhost-ல் வெளியிடப்பட்ட ports-ஐ அணுக அனுமதிக்கின்றன. மேலும், configured direct routing, loopback-ல் வெளியிட்டாலும் container port-ஐ வெளிப்படுத்தக்கூடும். Docker 28.0.0 அல்லது அதற்குப் பிந்தைய பதிப்பைப் பயன்படுத்துங்கள் மற்றும் setup-ன் போது direct routing-ஐ முடக்கி வையுங்கள். Upstream'3010:3010'அனைத்து interface-களையும் இணைக்கிறது; பெரும்பாலான VPS images-ல் இது public interface-ஐயும் உள்ளடக்கும்.POSTGRES_HOST_AUTH_METHOD: trustநீக்கப்பட்டு, அதற்குப் பதிலாக கடவுச்சொல் அமைக்கப்பட்டுள்ளது. Trust authentication, அந்த database-க்கு வரும் எந்த இணைப்பையும் கடவுச்சொல் இன்றிaffineபயனராக ஏற்கும். இது private Compose network-க்குள் மட்டுமே கட்டுப்படுத்தப்பட்டுள்ளது. நீங்கள் அந்த network-ல் மற்றொரு container-ஐ இணைக்கும் வரை அல்லது debugging-ன் போது 5432-ஐ வெளியிடும் வரை இது பாதுகாப்பானது.redis:8-alpine, வெறும்redis-க்கு மாற்றாக உள்ளது, இதுlatest-ஆகத் தீர்க்கப்படுகிறது. ஆகஸ்ட் 2026 நிலவரப்படி அது Redis 8 ஆகும். எனவே, இந்த pin நீங்கள் சோதித்த major version-ஐ அப்படியே வைத்திருக்கும், மேலும் தேவையற்றdocker compose pull-ன் போது எதிர்காலத்தில் Redis 9 தானாக வருவதைத் தடுக்கும்.pgvector/pgvector:pg16, மேலே கூறப்பட்ட காரணத்திற்காக upstream அமைத்தபடியே அப்படியே இருக்கும்.
POSTGRES_PASSWORD, Postgres முதல்முறையாக அதன் தரவு அடைவை உருவாக்கும்போது மட்டுமே வாசிக்கப்படும். ஏற்கனவே உள்ள instance-ல், docker compose exec postgres psql -U affine -c "ALTER USER affine WITH PASSWORD 'yourpassword'" மூலம் கடவுச்சொல்லை அமைத்துவிட்டு, அதற்கேற்ப DATABASE_URL-ஐப் புதுப்பிக்கவும்.
config/config.json கோப்பில் உள்ள கட்டமைப்பு
AFFiNE தனது அமைப்புகளை config/config.json-லிருந்து படிக்கிறது, இது நீங்கள் /root/.affine/config-ல் மவுண்ட் செய்த கோப்பகம் (directory) ஆகும். அந்த கோப்பை யாரும் உங்களுக்காக உருவாக்க மாட்டார்கள், எனவே முதல் முறை தொடங்குவதற்கு முன்பே அதை நீங்களே உருவாக்க வேண்டும். ~/affine/config/config.json-ஐ ஒரு எடிட்டரில் திறந்து, கீழே உள்ள உள்ளடக்கத்தை அதில் சேர்க்கவும். உதாரணத்திற்குப் பதிலாக உங்கள் சொந்த டொமைன் பெயரைப் பயன்படுத்தவும்:
{
"$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 என்பது பயனர்கள் தங்கள் உலாவியில் (browser) உண்மையில் திறக்கும் முகவரியாக இருக்க வேண்டும். AFFiNE இந்த மதிப்பைக் கொண்டே பகிரும் இணைப்புகளையும் (share links) பணிமனை அழைப்புகளையும் (workspace invitations) உருவாக்குகிறது. எனவே, இதை http://localhost:3010 என்றே விட்டால், நீங்கள் அனுப்பும் அழைப்பு பெறுநரின் சொந்த கணினியையே சுட்டிக்காட்டும், இதனால் அது வேலை செய்யாது. முதல் முறை தொடங்குவதற்கு முன்பே இதை பொதுவான HTTPS முகவரிக்கு அமைத்துவிடுங்கள்; அப்போதுதான் கோப்பிற்கும் நிர்வாகக் குழுவிற்கும் (admin panel) இடையே முரண்பாடு இருக்காது. நிர்வாகக் குழுவில் நீங்கள் பின்னர் மாற்றும் அமைப்புகள் தரவுத்தளத்தில் (database) சேமிக்கப்படுமே தவிர, இந்தக் கோப்பில் மீண்டும் எழுதப்படாது.
copilot என்பது AI அம்சங்களைக் கட்டுப்படுத்துகிறது. copilot.byok.enabled என்பது 'bring-your-own-key' சுவிட்ச் ஆகும்; இது பணிமனை உரிமையாளர் தனது சொந்த மாடல் வழங்குநர் சாவியை (model provider key) பணிமனை அமைப்புகளில் உள்ளிட அனுமதிக்கிறது. AFFiNE-ஐ நீங்களே ஹோஸ்ட் செய்யும்போது (self-hosting) AI சந்தா இதில் அடங்காது. உங்களுக்கு இது தேவையில்லை என்றால், இரண்டையும் false என விட்டுவிடவும்.
Stack-ஐத் தொடங்கவும்:
docker compose up -d
docker compose ps --alldocker compose ps --all கட்டளையானது affine_postgres மற்றும் affine_redis ஆகியவை ஆரோக்கியமாக (healthy) இருப்பதையும், affine_server இயங்கிக் கொண்டிருப்பதையும், affine_migration_job ஆனது exited (0) நிலையில் இருப்பதையும் காட்ட வேண்டும். --all முக்கியமானது: இது இல்லையென்றால், docker compose ps இயங்கும் கன்டெய்னர்களை மட்டுமே காட்டும். இதனால், வெற்றிகரமாக முடிவடைந்த மைக்ரேஷன் பணி (migration job) பட்டியலில் தெரியாது. மைக்ரேஷன் பணியில் வேறு ஏதேனும் எக்சிட் கோட் (exit code) இருந்தால், அதைத்தான் நீங்கள் கவனிக்க வேண்டும். அதன் லாக் (log) கோப்பு, எந்த இடத்தில் பணி நின்றது என்பதைக் காட்டும்:
docker compose logs affine_migrationமறப்பதற்கு முன்பாக image-ஐ pin செய்யவும்
stable என்பது அடிக்கடி மாறும் ஒரு tag ஆகும். AFFiNE-ன் release workflow, ஒவ்வொரு stable build-க்கும் பல tags-ஐ வழங்குகிறது. அவற்றில் இரண்டு முக்கியமானவை: ஒவ்வொரு release-க்கும் மாற்றப்படும் stable, மற்றும் git short hash-ஐக் கொண்ட stable-. நீங்கள் stable-ல் வைத்திருந்தால், ஆறு மாதங்களுக்குப் பிறகு ஒரு docker compose pull-ஐ இயக்கும்போது, அது வேறு ஒரு image-ஐத் தரவிறக்கம் செய்து, நீங்கள் எதிர்பாராத நேரத்தில் database migrations-ஐச் செய்துவிடும். நீங்கள் சோதித்த அதே 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: வரியிலும் paste செய்யவும். இவை இரண்டும் ஒரே image-ஐ இரண்டு வெவ்வேறு பணிகளுக்குப் பயன்படுத்துவதால், அவை எப்போதும் ஒன்றாக இருக்க வேண்டும். இல்லையெனில், ஒரு schema-வில் database-ஐ migrate செய்துவிட்டு, வேறொரு schema-வில் அதை இயக்க நேரிடும். எனவே, upgrade செய்வது என்பது தற்செயலாக நடக்காமல், திட்டமிட்டுச் செய்யப்பட வேண்டும்: digest-ஐ மாற்றவும், backup எடுக்கவும், பின் docker compose pull மற்றும் docker compose up -d செய்யவும்.
வேறொருவர் செய்வதற்கு முன்பே நிர்வாகி கணக்கை உருவாக்குதல்
புதிய instance-ல் /admin-ஐத் திறந்தால், server-ல் இன்னும் நிர்வாகி இல்லாததால் AFFiNE உங்களை கணக்கு உருவாக்கும் பக்கத்திற்கு அழைத்துச் செல்லும். அந்தச் செயல்பாட்டில் அழைப்புக் குறியீடோ (invitation code) அல்லது setup token-ஓ கிடையாது. முதலில் பதிவு செய்பவரே உங்கள் server-ன் நிர்வாகி ஆகிவிடுவார், எனவே நீங்கள் பதிவு செய்யும் வரை அந்த port-ஐத் திறக்கக்கூடாது.
இதனால்தான் மேலே உள்ள compose file 127.0.0.1-ல் பிணைக்கப்பட்டுள்ளது (bind). உங்கள் கணினியிலிருந்து SSH tunnel வழியாக அதை அணுகவும்:
ssh -L 3010:127.0.0.1:3010 you@your-server-ipஅதை இயங்கவிட்டு, உங்கள் உள்ளூர் உலாவியில் (local browser) http://127.0.0.1:3010/admin-ஐத் திறக்கவும். பதிவு செய்து உள்நுழைந்த பிறகு, tunnel-ஐ மூடிவிடவும். இப்போதுதான் அந்த instance-ஐ பொதுப் பெயரில் (public name) வைப்பது பாதுகாப்பானது. இதேபோன்ற போட்டி நிலை (race condition) பிற self-hosted செயலிகளிலும் உள்ளது. முதல் உள்நுழைவு hostname-உடன் பிணைக்கப்பட்ட passkey-ஐ உருவாக்கும்போது இது இன்னும் சிக்கலானது. இதனால்தான் நீங்கள் self-host openGym செய்யும்போது, முதல் கணக்கை உருவாக்கும் முன்பே TLS மற்றும் இறுதி domain-ஐ உறுதிப்படுத்த வேண்டும்.
AFFiNE உங்கள் தரவை எங்கு சேமிக்கிறது
மூன்று பாதைகள் அனைத்தையும் கொண்டுள்ளன, இவை அனைத்தும் நீங்கள் உருவாக்கிய directory-க்குள் அமைகின்றன.
./data/postgresஎன்பது Postgres தரவு directory ஆகும்: ஆவணங்கள், பயனர்கள், workspaces, அனுமதிகள் மற்றும் admin panel-லிருந்து சேமிக்கப்பட்ட server அமைப்புகள் அனைத்தும் இதில் உள்ளன../data/storageஎன்பது container-ல்/root/.affine/storageஎன்ற இடத்தில் mount செய்யப்பட்டுள்ளது, இது பதிவேற்றப்பட்ட அனைத்து கோப்புகளையும் கொண்டுள்ளது../configஎன்பது/root/.affine/configஎன்ற இடத்தில் mount செய்யப்பட்டுள்ளது, இதுconfig.jsonமற்றும் migration job மூலம் உருவாக்கப்பட்டprivate.keyஆகியவற்றைக் கொண்டுள்ளது.
Upstream இங்கே named volumes-க்கு பதிலாக bind mounts-ஐப் பயன்படுத்துகிறது, இந்தத் தேர்வு வேண்டுமென்றே செய்யப்பட்டது: Docker-ஐக் கேட்காமலேயே, சாதாரண கட்டளைகளைக் கொண்டு இந்தத் தரவுகளை tar செய்து நகலெடுக்க முடியும். இதன் விளைவாக, host-ல் உள்ள கோப்புகளின் உரிமையாளர் (file ownership) தொடர்பான நிர்வாகம் உங்கள் பொறுப்பாகிறது; இது bind mounts மற்றும் named volumes பகுதியில் விவரிக்கப்பட்டுள்ள பரிமாற்றமாகும்.
AFFiNE-ஐ எவ்வாறு பேக்கப் செய்வது
இரண்டு விஷயங்களை பேக்கப் செய்ய வேண்டும், அவை வெவ்வேறு முறைகளில் பேக்கப் செய்யப்படுகின்றன. தரவுத்தளம் (database) ஒரு இயங்கும் server என்பதால், அது இயங்கிக்கொண்டிருக்கும்போது அதன் கோப்புகளை நகலெடுப்பது சிதைந்த நகலை மட்டுமே தரும். அதற்குப் பதிலாக அதை 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 வழியாக இயங்குவதால், கடவுச்சொல்லைக் கேட்காது. ls வெளியீட்டில் அதன் அளவைச் சரிபார்க்கவும். சில நூறு bytes அளவுள்ள கோப்பு இருந்தால், dump தோல்வியடைந்துள்ளது என்று அர்த்தம், ஆனால் shell அந்த கோப்பை உருவாக்கியிருக்கும்; இதுதான் ஆறு மாதங்களுக்குப் பிறகு கண்டறியப்படும் தோல்வியாகும். -T-ம் முக்கியமானது: அது இல்லையென்றால், Compose ஒரு terminal-ஐ ஒதுக்கி binary stream-ஐச் சிதைக்கக்கூடும்.
பதிவேற்றப்பட்ட கோப்புகள் வெறும் கோப்புகள் மட்டுமே, எனவே அவற்றை tar செய்யவும்:
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 கோப்பு மற்றும் .env ஆகியவற்றை உங்கள் பேக்கப்பில் வைத்திருக்கவும், ஏனெனில் dump-ல் இவை இருக்காது. Migration பணியானது config/private.key-ஐயும் உருவாக்குகிறது, எனவே config.json-ஐ மட்டும் நகலெடுப்பது அந்த கோப்பைத் தவிர்த்துவிடும். Admin panel-ல் சேமிக்கப்பட்ட அமைப்புகள் தரவுத்தளத்தில் சேமிக்கப்படுகின்றன, எனவே மேலே உள்ள dump அவற்றை உள்ளடக்கியிருக்கும். 12 October 2026 நிலவரப்படி, மாற்றியமைக்கப்பட்ட server அமைப்புகளை admin panel-லிருந்தும் export செய்ய முடியும் என்று AFFiNE-ன் பேக்கப் பக்கம் குறிப்பிடுகிறது. இந்த மூன்று கோப்புகளையும் server-லிருந்து வெளியே நகலெடுக்கவும். தரவு இருக்கும் அதே வட்டில் பேக்கப் எடுப்பது உண்மையான பேக்கப் ஆகாது. தரவுத்தள dump மற்றும் uploads directory-ன் tar கோப்பு ஆகியவற்றைச் சேமிக்கும் இந்த முறையே, நீங்கள் இயக்கும் மற்ற அனைத்து stateful container-களுக்கும் பின்பற்றப்பட வேண்டியதாகும். Chatwoot-ஐ support desk-ஆக self-host செய்வது போன்ற சூழல்களில், உரையாடல் வரலாறு மற்றும் இணைப்புகளைப் பாதுகாப்பாக வைத்திருக்க இதே முறைதான் பயன்படுகிறது.
மீட்டெடுப்பு (Restoring) மற்றும் வெளியிடப்பட்ட வழிமுறைகளில் உள்ள ஒரு சிக்கல்
மீட்டெடுப்புக்கான அதிகாரப்பூர்வ வழிமுறைகளைத் தேவைப்படும் முன்பே கவனமாகப் படித்துக்கொள்ளுங்கள். ஆகஸ்ட் 2026-ல் வெளியிடப்பட்ட வழிமுறைகளில், affine.backup என்ற கோப்பை container-க்குள் நகலெடுத்து, பின்னர் ./pg.backup-லிருந்து மீட்டெடுக்கச் சொல்லியிருந்தனர்; இவை இரண்டு வெவ்வேறு பெயர்கள். மேலும், தற்போதைய compose கோப்பு அதன் தரவை ./data/postgres-ல் வைத்திருக்கும் நிலையில், அவர்கள் ./postgres கோப்பகத்தை நீக்கச் சொல்லியிருந்தனர். அக்டோபர் 12, 2026 நிலவரப்படி, அந்தப் பக்கம் முழுவதும் affine.backup-ஐப் பயன்படுத்துகிறது. மீட்டெடுப்பு சரிபார்க்கப்படும் வரை பழைய Postgres கோப்பகத்தை வைத்திருக்குமாறும் அறிவுறுத்துகிறது. எனவே, இந்தச் சிக்கல் upstream-ல் சரிசெய்யப்பட்டுவிட்டது; ஆனால், அதற்கு முன்பு சேமிக்கப்பட்ட வழிமுறைகளில் இன்னும் அந்தப் பிழை இருக்கலாம். எது எப்படியிருந்தாலும், ஏதேனும் ஒரு snippet-ல் உள்ள பாதைகளைப் பின்பற்றுவதற்குப் பதிலாக, நீங்கள் உண்மையில் பயன்படுத்திய பாதைகளையே பின்பற்றுங்கள். இந்த வழிகாட்டியில் உள்ள அமைப்பிற்கான வரிசைமுறை இதோ:
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-ஐக் கவனிக்கவும். நீங்கள் நகல் எடுக்காத ஒரு database-ன் மீது மீட்டெடுப்பது, ஒரு தவறான கட்டளையினால் முழு தரவு இழப்புக்கு வழிவகுக்கும். பழைய கோப்பகத்தை நகர்த்துவதால் எந்த இழப்பும் இல்லை. tar xzf backup/storage-2026-08-08.tgz -C data-ஐப் பயன்படுத்தி uploads-களையும் மீட்டெடுக்கவும்; இல்லையெனில், ஒவ்வொரு ஆவணத்திலும் உள்ள இணைப்புகள் (attachments) சிதைந்துவிடும். அதன் பிறகு, உள்நுழைந்து (log in) ஒரு படம் உள்ள ஆவணத்தைத் திறந்து பார்க்கவும். அதுவே இதற்கான சோதனை. நீங்கள் browser-ல் திறந்து பார்க்காத ஒரு மீட்டெடுப்பு என்பது வெறும் கோப்பு மட்டுமே, அது backup அல்ல.
ஏற்கனவே இயங்கும் proxy-ன் பின்னால் AFFiNE-ஐ அமைத்தல்
AFFiNE, WebSocket-ஐப் பயன்படுத்துகிறது, இது கட்டாயமானது. AFFiNE-ன் sync மற்றும் collaboration முறைக்கு WebSocket அடிப்படையாக இருப்பதால், அதை upgrade செய்யாத proxy-ஐப் பயன்படுத்தினால், workspace-ல் செய்யப்படும் மாற்றங்கள் sync ஆகாது என்று ஆவணங்கள் தெளிவாகக் கூறுகின்றன. பக்கம் ஏற்றப்படும், login வேலை செய்யும், ஆனால் ஒரு browser-ல் செய்யப்படும் மாற்றம் மற்றொன்றுக்குச் செல்லாது. உங்கள் browser-ன் developer tools-ல் Network tab-ஐத் திறந்து WS என்று filter செய்யவும். ஒரு connection மீண்டும் மீண்டும் திறக்கப்பட்டு மூடப்பட்டால், அந்த proxy upgrade-ஐ அனுமதிக்கவில்லை என்று அர்த்தம்.
நீங்கள் ஏற்கனவே பிற containers-க்காக Traefik-ஐப் பயன்படுத்துகிறீர்கள் என்றால், AFFiNE-ஐ ஒரு சாதாரண service-ஆக அதனுடன் இணைக்கலாம். ports: தொகுதியை affine service-லிருந்து நீக்கிவிட்டு, பின்வருவனவற்றைச் சேர்க்கவும்:
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'கோப்பின் இறுதியில், services:-க்கு அருகில்:
networks:
proxy:
external: trueCertificate resolver பெயர் உங்கள் Traefik configuration-ல் வரையறுக்கப்பட்ட பெயருடன் ஒத்துப்போக வேண்டும். loadbalancer.server.port என்பது container port 3010 ஆகும், இது host port அல்ல. Traefik எந்த கூடுதல் configuration-ம் இன்றி WebSocket connections-ஐ proxy செய்யும். உங்கள் stack-ல் உள்ள பிற சேவைகள் ஏற்கனவே single sign-on-க்கான Authentik-ன் பின்னால் இருந்தால், இந்த router-ல் ஒரு forward auth middleware-ஐப் பயன்படுத்தி AFFiNE-க்கான browser access-ஐக் கட்டுப்படுத்தலாம். ஆனால், 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 இயல்பாக 1 MB ஆக இருக்கும். அந்த வரி இல்லையென்றால், சிறிய புகைப்படத்தை விடப் பெரிய கோப்புகளை upload செய்யும்போது 413 status பிழை ஏற்படும். கோரிக்கை வந்து சேராததால் AFFiNE logs-ல் எதுவும் பதிவாகாது. Caddy-க்கு reverse_proxy http://127.0.0.1:3010 என்ற ஒரே ஒரு வரி போதும், அதுவே certificates மற்றும் WebSocket upgrades-ஐக் கவனித்துக்கொள்ளும்.
Self-hosted முறையில் விடுபட்டவை
ஒரு குழுவை இதற்கு மாற்றும் முன், பின்வரும் உண்மைகளைத் தெளிவாகப் புரிந்துகொள்ளுங்கள்.
நிகழ்நேர ஒத்துழைப்பு (Real-time collaboration) இதில் உள்ளது; AFFiNE-ன் ஆவணங்களின்படி, மெமரி பயன்பாடு என்பது sync system மற்றும் document merging ஆகியவற்றால் ஏற்படுவதால், இந்த அம்சத்தை அடிப்படையாகக் கொண்டே அளவீட்டு ஆலோசனைகள் வழங்கப்படுகின்றன. ஆஃப்லைனில் எடிட் செய்யும் வசதிக்காகவே பலர் local-first கருவிகளை நாடுகின்றனர். desktop application-ல் உங்கள் self-hosted server-ஐ workspace பட்டியலில் சேர்த்து லாக்-இன் செய்ய முடியும். உங்கள் குழு சார்ந்திருக்கும் ஆஃப்லைன் செயல்பாடுகளை முழுமையாகச் சோதித்த பின்னரே முடிவெடுங்கள்: நெட்வொர்க் இல்லாத நிலையில் desktop app-ல் எடிட் செய்து, மீண்டும் இணைத்த பிறகு, மற்றொரு சாதனத்தில் முடிவுகளைச் சரிபார்க்கவும். அம்சங்களின் பட்டியல் (Feature lists) மட்டுமே ஆதாரமாகாது, இந்த பட்டியலும் அதற்கு விதிவிலக்கல்ல.
வழங்கப்பட்ட compose கோப்பில் server-side full-text search முடக்கப்பட்டுள்ளது, அங்கு AFFINE_INDEXER_ENABLED=false என்பது server மற்றும் migration job இரண்டிலும் அமைக்கப்பட்டுள்ளது. இதைச் செயல்படுத்துவது என்பது Manticore Search container-ஐச் சேர்ப்பதாகும்; இது ஐந்தாவது service என்பதால் கூடுதல் மெமரி தேவைப்படும். 2 GB மெமரி கொண்ட server-ல், இந்த மாற்றம் உங்கள் பயன்பாட்டை வரம்பிற்கு மேல் கொண்டு செல்லும். நீங்கள் திறந்து வைத்துள்ள workspace-ல் client-க்குள் இருக்கும் தேடல் வசதி தொடர்ந்து செயல்படும்.
பயனர்களை அழைக்கும் முன் இரண்டு வரம்புகளைத் தெரிந்துகொள்வது அவசியம். ஒரு self-hosted workspace-க்கு அதிகபட்சம் 10 இடங்கள் (seats) மட்டுமே வழங்கப்படும்; அதற்கு மேல் தேவைப்பட்டால் AFFiNE-னிடம் Team license பெற வேண்டும். self-hosted instances-க்கு வரம்பற்ற blob storage மற்றும் வரம்பற்ற blob அளவு ஆகியவை ஆவணங்களில் குறிப்பிடப்பட்டிருந்தாலும், அக்டோபர் 2026 நிலவரப்படி அவை முழுமையாகச் செயல்படுத்தப்படவில்லை. ஒரு குடும்பத்திற்கோ அல்லது சிறிய குழுவிற்கோ இது பெரிய பாதிப்பை ஏற்படுத்தாது. ஆனால், நாற்பது பேரை மாற்றத் திட்டமிட்டால், இவை முக்கியமானவை.
மேம்படுத்தல்கள் (Upgrades)
முதலில் release notes-ஐ வாசிக்கவும். குறிப்பாக 0.26 முதல் 0.27 போன்ற minor version மாற்றங்களின்போது, சில breaking changes இருக்கலாம். எதையும் மாற்றும் முன் database மற்றும் storage directory-ஐ backup எடுக்கவும். ஏனெனில், அடுத்த முறை தொடங்கும் போது migration job உங்கள் schema-வை மாற்றியமைக்கும்; இதை மீண்டும் பழைய நிலைக்குக் கொண்டுவர முடியாது. அதன் பிறகு pinned digest-ஐ மாற்றவும், docker compose pull கட்டளையை இயக்கி, தொடர்ந்து docker compose up -d கட்டளையை இயக்கவும். docker compose logs -f affine_migration கட்டளையை கவனித்து, அது வெற்றிகரமாக முடியும் வரை காத்திருக்கவும். அதன் பிறகு docker image prune பழைய layers-ஐ நீக்கும். மிகப்பழைய பதிப்பைப் பயன்படுத்துபவர்களுக்கு ஒரு வரலாற்றுத் தகவல்: 0.23.0 பதிப்பிலிருந்து image பெயர் affine-graphql என்பதிலிருந்து affine என மாற்றப்பட்டது. எனவே, அதற்கு முந்தைய compose file-ஐப் பயன்படுத்துகிறீர்கள் என்றால், pull செய்வதற்கு முன்னால் அதில் உள்ள image வரிகளை மாற்றியமைக்க வேண்டும். மேலும், 0.27.4 பதிப்பிலிருந்து, அதிகாரப்பூர்வ compose template-ல் Postgres, upload மற்றும் configuration பாதைகள் மாற்றப்பட்டுள்ளன; default database connection-ம் மாற்றப்பட்டுள்ளது. எனவே, ஏற்கனவே இயங்கிக்கொண்டிருக்கும் ஒரு install-ன் மீது புதிய கோப்பை அப்படியே நகலெடுப்பதற்குப் பதிலாக, புதிய கோப்பை உங்கள் கோப்புடன் ஒப்பிட்டுப் பார்த்து மாற்றங்களைச் செய்யவும்.
FAQ
AFFiNE container ஏன் தொடங்குவதில்லை?
affine service, affine_migration job-ல் condition: service_completed_successfully-ஐக் குறிப்பிடுகிறது. எனவே, migration செயல்முறை 0 அல்லாத ஏதேனும் ஒரு status-ல் நின்றால், server தொடங்கப்படாது; web interface-ம் தோன்றாது. எந்தக் கட்டத்தில் செயல்முறை நின்றது என்பதை அறிய docker compose logs affine_migration கட்டளையை இயக்கவும். கையால் திருத்தப்பட்ட compose file-ல் pgvector/pgvector:pg16 பயன்படுத்தப்பட்டுள்ளதா என்பதைச் சரிபார்க்கவும். v0.27.4 பதிப்பில் v0.27.3-ல் இருந்த நான்கு embedding மாதிரிகள் வரையறுக்கப்படவில்லை என்றாலும், AFFiNE-ன் schema இன்னும் pgvector extension-ஐக் கோருவதால், stock Postgres-ல் அது இயங்காது.
self-hosted AFFiNE-க்கு எவ்வளவு RAM தேவை?
AFFiNE-ன் தேவைகள் பக்கத்தில் குறைந்தபட்சம் 4 CPU cores மற்றும் 2 GB RAM பரிந்துரைக்கப்படுகிறது. ஆவணங்கள் 10,000 சொற்களைத் தாண்டும்போது இது 4 GB-ஆக உயர்கிறது. 10,000 மாற்றங்களைக் கொண்ட ஒரு ஆவணத்தை இணைக்கும்போது 1 GB வரை peak load ஏற்படலாம் என்று அது குறிப்பிடுகிறது. 2 GB RAM கொண்ட server-ல், idle load-ஐ விட இந்த peak load-தான் சிக்கலை ஏற்படுத்துகிறது. Kernel-ன் out-of-memory killer, அதிக RAM பயன்படுத்தும் ஒரு process-ஐ நிறுத்திவிடும்; பெரும்பாலும் அது AFFiNE server-ஆகவே இருக்கும். restart: unless-stopped அதை மீண்டும் தொடங்குவதால், பயனர்களுக்குப் பிழை செய்திக்கு பதிலாகப் பக்கம் மீண்டும் ஏற்றப்படுவதைக் (page reload) காணலாம். இதை docker inspect affine_server --format '{{.State.OOMKilled}}' மற்றும் sudo dmesg -T | grep -i 'out of memory' மூலம் உறுதிப்படுத்தவும். சிறிய அளவிலான spikes-ஐச் சமாளிக்க 2 GB swap file-ஐச் சேர்க்கவும்; ஒருவேளை process நிறுத்தப்படுவது தொடர்ந்தால், RAM-ஐ 4 GB-க்கு உயர்த்தவும்.
AFFiNE எனது தரவை எங்கே சேமிக்கிறது, எதை backup எடுக்க வேண்டும்?
உங்கள் compose directory-க்குக் கீழே உள்ள மூன்று பாதைகளில் அனைத்தும் சேமிக்கப்படும்: database-க்கு ./data/postgres, பதிவேற்றப்பட்ட கோப்புகளுக்கு ./data/storage, மற்றும் config.json மற்றும் உருவாக்கப்பட்ட private.key-க்கு ./config. இயங்கிக்கொண்டிருக்கும் Postgres-ஐ அப்படியே நகலெடுப்பது பாதுகாப்பானது அல்ல என்பதால், கோப்புகளை நகலெடுப்பதற்குப் பதிலாக docker compose exec -T postgres pg_dump --format c --username affine affine > affine.dump மூலம் database-ஐ backup எடுக்கவும். AFFiNE தனது அமைப்புகளை database-ல் சேமிப்பதால், அந்த dump-ல் admin panel-ல் சேமிக்கப்பட்ட அனைத்து அமைப்புகளும் இருக்கும். பதிவேற்றங்களுக்கு ./data/storage-ஐ tar செய்யவும். முழுமையான config directory, Compose file மற்றும் .env ஆகியவற்றைச் சேமித்து வைக்கவும், ஏனெனில் இவை database-ன் பகுதிகள் அல்ல.
self-hosted AFFiNE-ல் real-time collaboration வேலை செய்யுமா?
ஆம், இதற்குத் தனியாக எதையும் இயக்க வேண்டியதில்லை. sync செயல்பாடு WebSocket connections வழியாக நடப்பதால், உங்கள் reverse proxy-ல் மட்டும் ஒரு தேவை உள்ளது. Nginx பயன்படுத்தினால், proxy_http_version 1.1 உடன் Upgrade மற்றும் Connection: upgrade headers-ஐச் சேர்க்க வேண்டும். Traefik மற்றும் Caddy எந்த கூடுதல் அமைப்பும் இன்றி இந்த இணைப்புகளை அனுமதிக்கும். proxy இந்த இணைப்புகளை upgrade செய்யவில்லை என்றால், workspace மற்றும் login சரியாக வேலை செய்யும், ஆனால் ஒரு browser-ல் செய்யப்படும் மாற்றங்கள் மற்றொன்றில் தெரியாது.
stock Postgres image-ஐப் பயன்படுத்தி AFFiNE-ஐ இயக்க முடியுமா?
pgvector extension உடன் தொகுக்கப்பட்ட Postgres 16-ஆன pgvector/pgvector:pg16-ஐப் பயன்படுத்தவும். AFFiNE v0.27.4, schema.prisma-ல் extensions = [pgvector(map: "vector")]-ஐக் கோருகிறது, ஆனால் v0.27.3-ல் இருந்த vector(1024) embedding columns கொண்ட நான்கு மாதிரிகளை இப்போது வரையறுப்பதில்லை. stock Postgres-ல் இந்த extension இல்லை. நீங்கள் AFFiNE-ஐ ஒரு external Postgres server-க்கு இணைத்தால், migration-ஐ இயக்கும் முன்பே அதில் pgvector-ஐ நிறுவி, target database-ல் extension-ஐ உருவாக்கவும்.