Files
aitbc/docs/infrastructure/RUNTIME_DIRECTORIES.md
aitbc a7fbf58462
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Successful in 3s
Deploy to Testnet / deploy-testnet (push) Successful in 1m6s
Documentation Validation / validate-docs (push) Failing after 9s
Documentation Validation / validate-policies-strict (push) Successful in 5s
Multi-Node Stress Testing / stress-test (push) Successful in 3s
Node Failover Simulation / failover-test (push) Failing after 4s
docs: merge docs/project files into appropriate doc directories
- Moved ai-economics/ to docs/ai-economics/
- Moved completion/ to docs/completion/
- Merged cli/ with docs/cli/
- Merged infrastructure/ with docs/infrastructure/
- Moved planning/ to docs/planning/
- Moved requirements/ to docs/requirements/
- Moved workspace/ to docs/development/workspace/
- Moved 1_files.md to docs/reference/REPOSITORY_STRUCTURE.md
- Moved 2_roadmap.md to docs/ROADMAP.md
- Moved 3_infrastructure.md to docs/infrastructure/INFRASTRUCTURE.md
- Moved SECURITY.md to docs/security/SECURITY.md
- Moved PROJECT_STRUCTURE.md to docs/archive/GPU_PROJECT_STRUCTURE.md
- Moved WORKING_SETUP.md to docs/guides/getting-started/WORKING_SETUP.md
- Moved E2E_TEST_CREATION_SUMMARY.md to docs/reports/E2E_TEST_CREATION_SUMMARY.md
- Moved SQLMODEL_METADATA_FIX_SUMMARY.md to docs/reports/SQLMODEL_METADATA_FIX_SUMMARY.md
- Moved GITHUB_PULL_SUMMARY.md to docs/reports/GITHUB_PULL_SUMMARY.md
- Moved GIFT_CERTIFICATE_newuser.md to docs/guides/getting-started/GIFT_CERTIFICATE.md
- Moved user_profile_newuser.md to docs/guides/getting-started/USER_PROFILE.md
- Moved aitbc.md to docs/infrastructure/NODE_AITBC.md
- Moved aitbc1.md to docs/infrastructure/NODE_AITBC1.md
- Updated project/README.md with new documentation locations
- Removed empty subdirectories from docs/project/
- Created docs/MERGE_PLAN.md for reference
2026-05-09 21:52:55 +02:00

1.2 KiB

AITBC Runtime Directory Structure

This document outlines the standard Linux system directories used by AITBC for runtime data.

Standard System Directories

/var/lib/aitbc/

Purpose: Application data and databases

  • keystore/ - Blockchain private keys and certificates
  • data/ - Application databases (.db, .sqlite files)
  • logs/ - Application log files

/etc/aitbc/

Purpose: Configuration files

  • Environment files (.env)
  • Service configuration
  • Network settings

/var/log/aitbc/

Purpose: System logging (symlinked from /var/lib/aitbc/logs/)

Security & Permissions

  • Keystore: Restricted permissions (600/700)
  • Config: Read-only for services, writable for admin
  • Logs: Writable by services, readable by admin

Migration from Repo

Runtime data has been moved from /opt/aitbc/data/ to system standard directories:

  • Old: /opt/aitbc/data/keystore/ → New: /var/lib/aitbc/keystore/
  • Old: /opt/aitbc/data/ → New: /var/lib/aitbc/data/

SystemD Integration

Services should be updated to use these standard paths:

  • Environment=KEYSTORE_PATH=/var/lib/aitbc/keystore
  • Environment=DB_PATH=/var/lib/aitbc/data
  • Environment=LOG_PATH=/var/log/aitbc