fix: missing english i18n (#3176)

closes #3002

.dockerignore

@@ -1,4 +1,40 @@
 .dockerignore
 Dockerfile
+docker-compose.yml
+
+# Dev / build artifacts (recreated inside the build stage)
 node_modules
+dist
+src/gui/dist
+src/puter-js/dist
+*.tsbuildinfo
+
+# Local runtime data
+volatile
+config.json
+config.dev.json
 /puter
+
+# OS / editor
+.DS_Store
+.vscode
+.idea
+
+# Git / CI
+.git
+.github
+
+# Logs
+*.log
+npm-debug.log*
+.npm
+
+# Tests / coverage
+coverage
+.nyc_output
+
+# Secrets
+.env
+.env.*
+creds*
+*.pem

.env.example

@@ -1 +1,18 @@
-PORT=4000
+# Copy this file to `.env`, fill in the secrets, and `docker compose -f
+# docker-compose.full.yml up -d`. None of the defaults below are safe for
+# anything beyond a local laptop test.
+
+# ── Public-facing ports (nginx) ---------------------------------------
+HTTP_PORT=80
+# HTTPS_PORT=443     # uncomment after you enable TLS in nginx/nginx.conf
+
+# ── MariaDB ------------------------------------------------------------
+MARIADB_ROOT_PASSWORD=replace-with-strong-password
+MARIADB_DATABASE=puter
+MARIADB_USER=puter
+MARIADB_PASSWORD=replace-with-strong-password
+
+# ── S3 (RustFS) --------------------------------------------------------
+S3_ACCESS_KEY=puter
+S3_SECRET_KEY=replace-with-strong-secret
+S3_BUCKET=puter-local

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: ['HeyPuter']

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,25 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Issue Description**
-
-**Steps to Reproduce**
-
-**Expected & Actual Behavior**
-
-**Addition Information or Screenshots (if applicable)**
-
-**Deployment**
-- [ ] Production (puter.com)
-- [ ] Development (`npm run start`)
-- [ ] Docker (via `docker run`)
-- [ ] Docker (via `docker-compose`)
-
-**Puter version (if accessible)**
-> Click the profile button on the top-right, then "Settings". The version number will be printed at the bottom

.github/ISSUE_TEMPLATE/driver-request.md

@@ -1,10 +0,0 @@
----
-name: Driver Request
-about: Request a driver on Puter
-title: ''
-labels: ''
-assignees: ''
-
----
-
-> Drivers are services that apps on Puter can use. For example, drivers support many of the features in the [Puter SDK](https://docs.puter.com/). If you're not sure if what you're suggesting is a driver, you should use the "Feature Request" template instead.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,10 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for Puter
-title: ''
-labels: idea
-assignees: ''
-
----
-
-

.github/ISSUE_TEMPLATE/idea-for-improvement.md

@@ -1,10 +0,0 @@
----
-name: Idea for Improvement
-about: An enhancement for an existing feature on Puter
-title: ''
-labels: enhancement
-assignees: ''
-
----
-
-

.github/workflows/ai-provider-integration-tests.yaml

@@ -0,0 +1,49 @@
+name: AI Provider Integration Tests
+
+# Hits real provider APIs with cheap models, so this workflow is
+# manually triggered only. Each provider's test reads its credential
+# from PUTER_TEST_AI_<PROVIDER>_API_KEY and skips itself silently if
+# the secret is missing.
+
+on:
+    workflow_dispatch:
+
+permissions:
+    contents: read
+
+jobs:
+    ai-test:
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v4
+
+            - name: Set up Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: '24'
+                  cache: 'npm'
+
+            - name: Install dependencies
+              run: npm ci
+
+            - name: Run AI provider integration tests
+              # Vitest treats positional args as filename substring filters.
+              # The pattern matches every `*.integration.test.ts` file and
+              # nothing else — the regular backend test suite stays out.
+              run: npm run test:backend -- integration.test
+              env:
+                  CI: 'true'
+                  PUTER_TEST_AI_CLAUDE_API_KEY: ${{ secrets.PUTER_TEST_AI_CLAUDE_API_KEY }}
+                  PUTER_TEST_AI_OPENAI_API_KEY: ${{ secrets.PUTER_TEST_AI_OPENAI_API_KEY }}
+                  PUTER_TEST_AI_GEMINI_API_KEY: ${{ secrets.PUTER_TEST_AI_GEMINI_API_KEY }}
+                  PUTER_TEST_AI_GROQ_API_KEY: ${{ secrets.PUTER_TEST_AI_GROQ_API_KEY }}
+                  PUTER_TEST_AI_MISTRAL_API_KEY: ${{ secrets.PUTER_TEST_AI_MISTRAL_API_KEY }}
+                  PUTER_TEST_AI_DEEPSEEK_API_KEY: ${{ secrets.PUTER_TEST_AI_DEEPSEEK_API_KEY }}
+                  PUTER_TEST_AI_XAI_API_KEY: ${{ secrets.PUTER_TEST_AI_XAI_API_KEY }}
+                  PUTER_TEST_AI_OPENROUTER_API_KEY: ${{ secrets.PUTER_TEST_AI_OPENROUTER_API_KEY }}
+                  PUTER_TEST_AI_TOGETHER_API_KEY: ${{ secrets.PUTER_TEST_AI_TOGETHER_API_KEY }}
+                  PUTER_TEST_AI_MOONSHOT_API_KEY: ${{ secrets.PUTER_TEST_AI_MOONSHOT_API_KEY }}
+                  PUTER_TEST_AI_ZAI_API_KEY: ${{ secrets.PUTER_TEST_AI_ZAI_API_KEY }}
+                  PUTER_TEST_AI_ELEVENLABS_API_KEY: ${{ secrets.PUTER_TEST_AI_ELEVENLABS_API_KEY }}

.github/workflows/backend-tests.yaml

@@ -0,0 +1,77 @@
+name: Backend Tests
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - ref: ${{ github.base_ref }}
+            artifact: base
+          - ref: ${{ github.head_ref }}
+            artifact: pr
+
+    steps:
+      - name: Checkout ${{ matrix.ref }}
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ matrix.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run backend tests with coverage
+        run: npm run test:backend -- --coverage
+        env:
+          CI: 'true'
+
+      - name: Upload coverage artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: backend-coverage-${{ matrix.artifact }}
+          path: src/backend/coverage/
+          retention-days: 14
+
+  report-coverage:
+    needs: test
+    if: always()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Download PR coverage
+        uses: actions/download-artifact@v4
+        with:
+          name: backend-coverage-pr
+          path: src/backend/coverage
+
+      - name: Download base coverage
+        uses: actions/download-artifact@v4
+        with:
+          name: backend-coverage-base
+          path: coverage-base
+
+      - name: Report coverage on PR
+        uses: davelosert/vitest-coverage-report-action@v2
+        with:
+          json-summary-path: src/backend/coverage/coverage-summary.json
+          json-final-path: src/backend/coverage/coverage-final.json
+          json-summary-compare-path: coverage-base/coverage-summary.json

.github/workflows/build-and-test.yml

@@ -1,31 +0,0 @@
-# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
-
-name: Node.js CI
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-
-jobs:
-  build:
-
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [16.x, 18.x, 20.x, 21.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-    steps:
-    - uses: actions/checkout@v4
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-    - run: npm ci
-    - run: npm run build --if-present
-    - run: npm test

.github/workflows/check-translations.yml

@@ -1,28 +0,0 @@
-# This workflow runs the tools/check-translations.js script to make sure that the translation data is valid.
-
-name: Check Translations
-
-env:
-  NODE_VERSION: 21.x
-  # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v4
-    - name: Use Node.js ${{ env.NODE_VERSION }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ env.NODE_VERSION }}
-        cache: 'npm'
-        cache-dependency-path: ./package-lock.json
-    - run: npm ci
-    - run: npm run check-translations

.github/workflows/docker-image.yaml

@@ -1,86 +1,101 @@
-#
 name: Docker Image CI
 
-# Configures this workflow to run every time a change is pushed to the
-# branch called `main`.
+# Two ways in:
+#   - push of a calver tag (YY.MM or YY.MM.p) → publishes <version>, latest, main
+#   - workflow_dispatch → publishes latest + main from whichever ref the user
+#     picks in the Actions UI. Used to fast-forward :latest/:main when the
+#     branch has moved ahead of the most recent release tag.
 on:
-  push:
-    branches: ['release']
-  
+    push:
+        tags:
+            - '[0-9][0-9].[0-9][0-9]'
+            - '[0-9][0-9].[0-9][0-9].[0-9]*'
+    workflow_dispatch:
+        inputs:
+            push_latest:
+                description: 'Push :latest tag'
+                type: boolean
+                default: true
+            push_main:
+                description: 'Push :main tag'
+                type: boolean
+                default: true
 
-# Defines two custom environment variables for the workflow. These are used
-# for the Container registry domain, and a name for the Docker image that
-# this workflow builds.
 env:
-  REGISTRY: ghcr.io
-  IMAGE_NAME: ${{ github.repository }}
+    REGISTRY: ghcr.io
+    IMAGE_NAME: ${{ github.repository }}
 
-# There is a single job in this workflow. It's configured to run on the
-# latest available version of Ubuntu.
 jobs:
-  build-and-push-image:
-    runs-on: ubuntu-latest
+    build-and-push-image:
+        runs-on: ubuntu-latest
 
-    # Sets the permissions granted to the `GITHUB_TOKEN` for the actions
-    # in this job.
-    permissions:
-      contents: read
-      packages: write
+        permissions:
+            contents: read
+            packages: write
 
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
+        steps:
+            - name: Validate calver tag
+              if: github.event_name == 'push'
+              env:
+                  REF_NAME: ${{ github.ref_name }}
+              run: |
+                  if ! [[ "$REF_NAME" =~ ^[0-9]{2}\.[0-9]{2}(\.[0-9]+)?$ ]]; then
+                    echo "Tag '$REF_NAME' does not match YY.MM or YY.MM.p calver format."
+                    exit 1
+                  fi
 
-      # Uses the `docker/login-action` action to log in to the Container
-      # registry using the account and password that will publish the packages.
-      # Once published, the packages are scoped to the account defined here.
-      - name: Log in to GitHub Package Container registry
-        uses: docker/login-action@v3
-        with:
-          registry: ${{ env.REGISTRY }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-          
-      - name: Set up QEMU 
-        uses: docker/setup-qemu-action@v3
+            - name: Checkout repository
+              uses: actions/checkout@v4
 
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+            - name: Log in to GitHub Package Container registry
+              uses: docker/login-action@v3
+              with:
+                  registry: ${{ env.REGISTRY }}
+                  username: ${{ github.actor }}
+                  password: ${{ secrets.GITHUB_TOKEN }}
 
-      # This step uses [docker/metadata-action](https://github.com/docker/metadata-action#about)
-      # to extract tags and labels that will be applied to the specified image.
-      # The `id` "meta" allows the output of this step to be referenced in
-      # a subsequent step. The `images` value provides the base name for the
-      # tags and labels.
-      - name: Extract metadata (tags, labels) for Docker
-        id: meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-          tags: |
-            type=schedule
-            type=ref,event=branch
-            type=ref,event=pr
-            type=semver,pattern={{version}}
-            type=semver,pattern={{major}}.{{minor}}
-            type=semver,pattern={{major}},enable=${{ !startsWith(github.ref, 'refs/tags/v0.') }}
-            type=sha
-            type=raw,value=latest,enable=${{ github.ref == format('refs/heads/{0}', github.event.repository.default_branch) }}
+            - name: Log in to Docker Hub
+              uses: docker/login-action@v3
+              with:
+                  username: ${{ secrets.DOCKERHUB_USERNAME }}
+                  password: ${{ secrets.DOCKERHUB_TOKEN }}
 
-      # This step uses the `docker/build-push-action` action to build the
-      # image, based on your repository's `Dockerfile`. If the build succeeds,
-      # it pushes the image to GitHub Packages.
-      # It uses the `context` parameter to define the build's context as the
-      # set of files located in the specified path. For more information, see
-      # "[Usage](https://github.com/docker/build-push-action#usage)" in the
-      # README of the `docker/build-push-action` repository.
-      # It uses the `tags` and `labels` parameters to tag and label the image
-      # with the output from the "meta" step.
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v5
-        with:
-          platforms: linux/amd64,linux/arm64
-          context: .
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
+            - name: Set up QEMU
+              uses: docker/setup-qemu-action@v3
+
+            - name: Set up Docker Buildx
+              uses: docker/setup-buildx-action@v3
+
+            - name: Extract metadata (tags, labels) for Docker
+              id: meta
+              uses: docker/metadata-action@v5
+              with:
+                  images: |
+                      ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+                      heyputer/puter
+                  # type=ref,event=tag only emits on tag pushes, so manual runs skip
+                  # the calver tag and just publish whichever of latest / main the
+                  # dispatch inputs asked for. On a tag push, both default to true.
+                  tags: |
+                      type=ref,event=tag
+                      type=raw,value=latest,enable=${{ github.event_name == 'push' || inputs.push_latest }}
+                      type=raw,value=main,enable=${{ github.event_name == 'push' || inputs.push_main }}
+
+            - name: Build and push Docker image
+              uses: docker/build-push-action@v5
+              with:
+                  platforms: linux/amd64,linux/arm64
+                  context: .
+                  push: true
+                  tags: ${{ steps.meta.outputs.tags }}
+                  labels: ${{ steps.meta.outputs.labels }}
+                  cache-from: type=gha
+                  cache-to: type=gha,mode=max
+
+            - name: Sync README to Docker Hub
+              uses: peter-evans/dockerhub-description@v4
+              with:
+                  username: ${{ secrets.DOCKERHUB_USERNAME }}
+                  password: ${{ secrets.DOCKERHUB_TOKEN }}
+                  repository: heyputer/puter
+                  readme-filepath: ./README.md

.github/workflows/main.yml

@@ -0,0 +1,40 @@
+name: Maintain Release Merge PR
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  update-release-pr:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Git
+        run: |
+          git config user.name github-actions
+          git config user.email [email protected]
+      - name: Check for existing PR
+        id: find-pr
+        uses: juliangruber/find-pull-request-action@v1
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          branch: release
+      - uses: actions/checkout@v4
+        if: steps.find-pr.outputs.number == ''
+        with:
+          ref: release
+      - name: Reset release branch
+        if: steps.find-pr.outputs.number == ''
+        run: |
+          git fetch origin main:main
+          git reset --hard main
+      - name: Create/Update PR
+        if: steps.find-pr.outputs.number == ''
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: Update release branch
+          title: Merge Release Auto-PR
+          body: Merging this PR will invoke release actions          
+          branch: auto-update/release

.github/workflows/notify-prod.yaml

@@ -0,0 +1,18 @@
+name: Notify HeyPuter
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger heyputer build
+        run: |
+          curl -X POST \
+            -H "Authorization: token ${{ secrets.HEYPUTER_DISPATCH_TOKEN }}" \
+            -H "Accept: application/vnd.github.v3+json" \
+            https://api.github.com/repos/HeyPuter/heyputer/dispatches \
+            -d '{"event_type":"puter-main-updated","client_payload":{"puter_ref":"main"}}'

.github/workflows/tag-alias.yaml

@@ -0,0 +1,72 @@
+name: Tag Alias
+
+# Retags an existing image in GHCR under a custom name, without rebuilding.
+# Uses `docker buildx imagetools create` so the multi-arch manifest is preserved.
+# Re-running with the same name updates the alias to point at a different source tag.
+on:
+  workflow_dispatch:
+    inputs:
+      name:
+        description: "Alias name (e.g., potato)"
+        required: true
+      source_tag:
+        description: "Source tag to alias from"
+        required: false
+        default: "latest"
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  alias:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Validate alias name
+        env:
+          NAME: ${{ inputs.name }}
+        run: |
+          if ! [[ "$NAME" =~ ^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$ ]]; then
+            echo "Invalid alias name '$NAME' (allowed: [A-Za-z0-9_.-], must start with [A-Za-z0-9_], max 128 chars)."
+            exit 1
+          fi
+          if [[ "$NAME" == "latest" || "$NAME" == "main" ]]; then
+            echo "Alias name '$NAME' is reserved by the build workflow."
+            exit 1
+          fi
+          if [[ "$NAME" =~ ^[0-9]{2}\.[0-9]{2}(\.[0-9]+)?$ ]]; then
+            echo "Alias name '$NAME' looks like a calver tag — pick a non-version name."
+            exit 1
+          fi
+
+      - name: Log in to GitHub Package Container registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Create alias tag
+        env:
+          IMAGE: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          NAME: ${{ inputs.name }}
+          SOURCE_TAG: ${{ inputs.source_tag }}
+        run: |
+          SRC="${IMAGE}:${SOURCE_TAG}"
+          DST="${IMAGE}:${NAME}"
+          echo "Aliasing $DST -> $SRC"
+          docker buildx imagetools create -t "$DST" "$SRC"
+          {
+            echo "### 🏷️ Tag Alias"
+            echo ""
+            echo "- Source: \`$SRC\`"
+            echo "- Alias:  \`$DST\`"
+          } >> "$GITHUB_STEP_SUMMARY"

.gitignore

@@ -1,12 +1,72 @@
+# Misc
 .DS_Store
+
+# Dependencies
 node_modules/
+
 *.zip
 *.tgz
 license.config.json
 license-header.txt
+
+# Build Outputs
 dist/
-.vscode/
+
+# VS Code IDE
+.vscode/**/*
+!.vscode/extensions.json
+!.vscode/launch.json
+!.vscode/tasks.json
+
+# Local env files
 .env
+!.env.example
+
+# Per-developer / deployment config override. `config.default.json` ships in
+# the repo and is the authoritative source; `config.json` (if present) wins
+# at runtime for the local machine only.
+config.json
+
 # this is for jetbrain IDEs
 .idea/
 /puter
+
+# Local Netlify folder
+.netlify
+src/emulator/release/
+
+# ======================================================================
+# vscode
+# ======================================================================
+# vscode configuration
+.vscode/
+
+# JS language server, ref: https://code.visualstudio.com/docs/languages/jsconfig
+jsconfig.json
+
+# ======================================================================
+# playwright test (currently only test the file-system)
+# ======================================================================
+tests/client-config.yaml
+
+# ======================================================================
+# python
+# ======================================================================
+__pycache__/
+
+# ======================================================================
+# other
+# ======================================================================
+# AI STUFF
+AGENTS.md
+.roo
+
+# source maps
+*.map
+
+
+coverage/
+*.log
+undefined
+servers.json
+config.*.json

.husky/pre-commit

@@ -0,0 +1,15 @@
+#!/usr/bin/env sh
+
+files=$(git diff --cached --name-only --diff-filter=ACMR | \
+  grep -E '^(src/backend|extensions)/.*\.(js|mjs|cjs|ts)$' || true)
+
+if [ -z "$files" ]; then
+  exit 0
+fi
+
+echo "$files" | xargs npx eslint --fix --no-warn-ignored
+status=$?
+
+echo "$files" | xargs git add
+
+exit $status

.npmrc

@@ -0,0 +1 @@
+engine-strict=true

.prettierignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+build
+**/*.dbmig.js

.prettierrc.json

@@ -0,0 +1,4 @@
+{
+    "tabWidth": 4,
+    "singleQuote": true
+}

AGENTS.md

@@ -0,0 +1,99 @@
+# AGENTS.md
+
+Guidance for AI coding agents working in this repository. Read this before making changes. FOLLOW GUIDANCE AS CLOSELY AS POSSIBLE. If you think the guidance is wrong, raise an issue or flag a maintainer — don't just do what you think is right. This is the source of truth for how we write code, tests, and docs in this repo.
+
+## Documentation Index
+
+Use these as the source of truth before exploring further:
+
+- [README.md](README.md) — project overview and quickstart.
+- [doc/architecture.md](doc/architecture.md) — backend layered stack (controllers → drivers → services → stores → clients), `PuterServer` wiring, `Context` (ALS), and extensions.
+- [doc/self-hosting.md](doc/self-hosting.md) — running Puter outside hosted infra.
+- [CONTRIBUTING.md](CONTRIBUTING.md) — testing, security, AI-assisted code, PR conventions, Boy Scout Rule.
+- [SECURITY.md](SECURITY.md) — how to report vulnerabilities (do not file them publicly).
+- [BUG-BOUNTY.md](BUG-BOUNTY.md) — bounty program scope.
+- [TRADEMARK.md](TRADEMARK.md) — trademark usage.
+
+---
+
+## Backend
+
+The backend is organized as a layered stack inspired by Controller–Service–Repository with dependency injection. Every layer only depends on the layers beneath it, and `PuterServer` ([src/backend/server.ts](src/backend/server.ts)) wires the whole thing together.
+
+### Layers (top → bottom)
+
+| Layer           | Lives in                                             | Responsibility                                                                                                                                                 |
+| --------------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Controllers** | [src/backend/controllers/](src/backend/controllers/) | Route handlers. Parse + validate input, apply per-route gates (auth, subdomain, rate limit, body parsers via `RouteOptions`), call services, format responses. |
+| **Drivers**     | [src/backend/drivers/](src/backend/drivers/)         | Optional. RPC-style handlers exposed over `/drivers/*`. Thin shells that validate RPC inputs and call into services/stores.                                    |
+| **Services**    | [src/backend/services/](src/backend/services/)       | Business logic. Assume the caller is already authenticated/authorized — services do not run auth gates themselves.                                             |
+| **Stores**      | [src/backend/stores/](src/backend/stores/)           | Persistence. Wraps clients with the domain shape services consume (rows, entities, KV namespaces).                                                             |
+| **Clients**     | [src/backend/clients/](src/backend/clients/)         | Adapters for external/internal services (sql, redis, s3, dynamo, email, event bus). Knows protocols, not domain concepts.                                      |
+| **Config**      | `config.*.json` → `IConfig`                          | Flat, typed config object every layer receives at construction.                                                                                                |
+
+Each layer receives the layers beneath it through its constructor. Dependencies are explicit and traceable from `PuterServer`.
+
+### Cross-layer rules
+
+- **Don't reach across layers.** Controllers do not poke clients directly; services do not register routes. If you want to, the abstraction is wrong — fix the abstraction.
+- **Don't call sideways within a layer for code reuse.** If two services need the same logic, lift it into a util/helper. Services should not depend on other services for shared code.
+- **Prefer explicit arguments over `Context` (ALS).** Reach for [Context](src/backend/core/context.ts) only when the value is genuinely request-scoped and would otherwise thread through many layers. Today it's used sparingly — mostly for `actor` and `req`.
+
+### Extensions
+
+Extensions live in [extensions/](extensions/) and parallel the layered stack. They are for **non-crucial parts of the system** — things Puter still works without if removed. If a feature is load-bearing for clients, it belongs in core, not in an extension (see [whoami](extensions/whoami.ts) as the cautionary example).
+
+The `extension` global ([src/backend/extensions.ts](src/backend/extensions.ts)) exposes:
+
+- `extension.registerClient/Store/Service/Driver/Controller(name, Class)` for first-class additions.
+- `extension.on(event, handler)` and `extension.get/post/put/delete/patch/use(path, opts?, handler)` for the lightweight common case. `opts` is the same `RouteOptions` controllers use.
+- `extension.import('client' | 'store' | 'service' | 'controller' | 'driver')` returns a lazy proxy to instantiated objects. `extension.config` exposes live config.
+
+### Language & file conventions
+
+- **Modules:** We transpile and build as needed — write ES modules, not CommonJS.
+- **TypeScript preferred for new files.** Existing JS is fine; convert opportunistically when you're already touching a file.
+- **Reuse types before inventing them.** Search for an existing type first; extend it if close. Only define a new type when nothing fits.
+- **Make new types findable.** Co-locate them with the layer/module that owns them, export from the obvious entry point, and use a descriptive `PascalCase` name. Don't hide types in random files where future readers won't grep them.
+- **Naming:** `camelCase` for variables/functions, `PascalCase` for classes and for files containing a class (`AuthService.ts`, `KVStoreDriver.ts`).
+
+### Comments
+
+Keep comments light. Prefer self-documenting code — clear names, small functions, obvious flow. Add a comment **only** when:
+
+- The _why_ is non-obvious (a hidden constraint, a workaround, a subtle invariant).
+- A non-trivial usage detail would otherwise trip the next reader.
+
+Don't restate what the code already says. Don't write comments that reference the current task or PR — those rot.
+
+**No ticket references in code or test comments.** Don't write `PUT-1234`, `AUTH-3`, `GUI-2`, `// fix for FOO-99`, `// per ROLLOUT-1`, or section headers like `// -- PUT-1020: ... --`. The ticket exists in git history and the issue tracker; the code should describe the *why* in domain terms ("logout cascade transparently invalidates...") not project-management terms ("the cascade from AUTH-3..."). Same rule for test-block names and section dividers — describe what's being tested, not which ticket asked for it.
+
+**Use plain ASCII `-` in comment section dividers, not box-drawing characters.** Write `// -- Section name --`, not `// ── Section name ──`. The `─` (U+2500) character renders inconsistently in some editors and diff tools and adds nothing over `-`.
+
+### Tests
+
+When adding new behavior (function, endpoint, driver method, branch of logic), add a test for it.
+
+- Use Vitest for unit and integration tests. Test files go next to the code they test, named `*.test.ts` or `*.test.js`.
+- **Mock data, not methods.** Stub the inputs (fixtures, fake rows, sample payloads) rather than mocking the function under test or the layer beneath it. Over-mocking produces tests that pass while production breaks. If you must mock, mock at a real boundary (a client/external service), not within the same layer you're testing.
+- Prefer test server over mocking deps. We have existing test utilities for running full test server to boot deps based on config. (see [src/backend/testUtil.ts](src/backend/testUtil.ts)).
+- **Hit a real database / real client where reasonable.** Integration shapes catch the things unit tests with mocks miss.
+- **Regression tests for bug fixes.** A test that fails before your fix and passes after is the cheapest insurance against the bug coming back.
+- If something is genuinely hard to test (UI animation, third-party glue), skip it but say so in the PR.
+
+### Security & privacy
+
+Before opening a PR, scan the diff for:
+
+- Logs, error messages, or responses leaking internal paths, secrets, tokens, env vars, or other users' data.
+- Debug routes, test credentials, commented-out auth checks.
+- Endpoints returning more than the caller actually needs.
+
+When in doubt, return less. Auth-, permission-, or data-export-related changes deserve an explicit callout in the PR description.
+
+### Working rules of thumb
+
+- **Run it, don't just compile it.** "It type-checks" is not "it works." Exercise the code path end-to-end at least once.
+- **Read the neighbors before writing.** Match the shape of similar things already in the tree. If you genuinely think the existing pattern is wrong, raise it — don't quietly diverge.
+- **Boy Scout Rule, proportional to the change.** Fix the obvious typo, dead import, or missing typehint in files you're already touching. Don't ride a refactor along with a bug fix — that just makes review harder.
+- **Understand what you commit.** AI assistance is fine; shipping code you couldn't defend in review is not.

BUG-BOUNTY.md

@@ -0,0 +1,66 @@
+# Puter Bug Bounty Program
+
+We at **Puter** are committed to maintaining a secure experience for our users and community. We greatly value the contributions of security researchers and welcome responsible disclosure of security issues.
+
+## Scope
+
+The following are in scope for this program:
+
+* **The Puter open-source project** (available at [github.com/HeyPuter/puter](https://github.com/HeyPuter/puter))
+* **`puter.com`**
+* **`api.puter.com`**
+
+Out-of-scope:
+
+* Third-party services, applications, or libraries not maintained by Puter.
+* Social engineering attacks (e.g., phishing against staff).
+* Denial of Service (DoS), spam, or volumetric attacks.
+* Physical security issues.
+
+## Rules of Engagement
+
+To participate, you must:
+
+1. **Report responsibly**: Provide detailed steps to reproduce the issue, including proof-of-concept code or screenshots where applicable.
+2. **Do no harm**: Do not exfiltrate, modify, or delete data. Only access your own account or test data.
+3. **Respect availability**: Do not perform denial-of-service attacks or automated scans that degrade service.
+4. **Follow disclosure policy**: Do not publicly disclose vulnerabilities until we have confirmed and patched the issue.
+5. **Act in good faith**: Make every effort to avoid privacy violations, destruction of data, and interruption or degradation of services.
+
+Reports that do not meet these guidelines may not be eligible for a reward.
+
+## Reporting Process
+
+To report a vulnerability, email us at: **[[email protected]](mailto:[email protected])**.
+Include:
+
+* A description of the vulnerability
+* Steps to reproduce
+* Potential impact
+* Suggested remediation (if available)
+
+We aim to acknowledge receipt within **72 hours** and provide a resolution timeline.
+
+## Reward Structure
+
+We offer monetary rewards based on the severity of the vulnerability, as determined by our internal assessment (using CVSS as a guide).
+
+* **Critical: \$1,000 – \$2,000**
+* **High: \$500 – \$1,000**
+* **Medium: \$200 – \$500**
+* **Low: \$50 – \$100**
+
+Non-security issues, suggestions, and best practices feedback are always welcome, but may not qualify for a reward.
+If multiple researchers report the same issue, the bounty will be awarded to the first eligible report we receive.
+
+## Payments Disclaimer
+
+All reward amounts are **guidelines only**. Final decisions about eligibility, severity classification, and payout amount are made at the sole discretion of the Puter security team. We reserve the right to determine whether a report qualifies for a bounty, and whether any payment will be issued at all. Submitting a report does not guarantee compensation.
+
+### Payment Method Requirement
+
+At this time, **payments will only be made via PayPal**. To be eligible to receive a bounty, researchers must have a valid PayPal account capable of receiving payments. We are unable to process payments through other services or methods at this time.
+
+## Legal Safe Harbor
+
+If you make a good-faith effort to comply with this policy, we will consider your research to be authorized. If you inadvertently access data outside your own account, stop immediately and include details in your report so we can investigate and remediate.

CHANGELOG.md

@@ -1,9 +0,0 @@
-# Changelog
-
-## [2.1.1](https://github.com/HeyPuter/puter/compare/v2.1.0...v2.1.1) (2024-04-22)
-
-
-### Bug Fixes
-
-* test release-please action [#3](https://github.com/HeyPuter/puter/issues/3) ([8fb0a66](https://github.com/HeyPuter/puter/commit/8fb0a66ef21921990e564e5f61c0e80e7f929dc7))
-* test release-please action [#4](https://github.com/HeyPuter/puter/issues/4) ([f392de7](https://github.com/HeyPuter/puter/commit/f392de722a5232b622ed91b656a31cdc443c2e84))

CONTRIBUTING.md

@@ -1,101 +1,50 @@
-# Contributing to Puter
+# Contributing to Puter Backend
 
-Welcome to Puter, the open-source distributed internet operating system. We're excited to have you contribute to our project, whether you're reporting bugs, suggesting new features, or contributing code. This guide will help you get started with contributing to Puter in different ways.
+Thanks for contributing. These rules aren't strictly enforced — but following them makes every PR easier. If anything's unclear, ping a core maintainer or open the PR and ask.
 
-<br>
+New to the backend? Start with [doc/architecture.md](doc/architecture.md).
 
-# Report bugs
+---
 
-Before reporting a bug, please check our [the issues on our GitHub repository](https://github.com/HeyPuter/puter/issues) to see if the bug has already been reported. If it has, you can add a comment to the existing issue with any additional information you have.
+## 1. Test it. Run it.
 
-If you find a new bug in Puter, please [open an issue on our GitHub repository](https://github.com/HeyPuter/puter/issues/new). We'll do our best to address the issue as soon as possible. When reporting a bug, please include as much information as possible, including:
+Run the affected code path end-to-end before opening a PR. "It builds" is not "it works."
 
-- A clear and descriptive title
-- A description of the issue
-- Steps to reproduce the bug
-- Expected behavior
-- Actual behavior
-- Screenshots, if applicable
-- Your host operating system and browser
-- Your Puter version, location, ...
+Add tests for new behavior, endpoints, or bug fixes. If something's genuinely hard to test, say so in the PR.
 
-Please open a separate issue for each bug you find.
+## 2. Follow existing patterns
 
-Maintainers will apply the appropriate labels to your issue.
+Match the shape of similar code already in the repo. [doc/architecture.md](doc/architecture.md) is the source of truth for layers, wiring, and naming. If you think a pattern is wrong, raise it — don't quietly diverge.
 
-<br>
+## 3. Don't expose system or user information
 
-# Suggest new features
+Scan your diff for stray logs, debug routes, internal paths, secrets, tokens, or user data in errors/responses. When in doubt, return less. Flag any auth, permission, or data-export changes in the PR description.
 
-If you have an idea for a new feature in Puter, please open a new discussion thread on our [GitHub repository](https://github.com/HeyPuter/puter/discussions) to discuss your idea with the community. We'll do our best to respond to your suggestion as soon as possible.
+For private security reports, see [SECURITY.md](SECURITY.md).
 
-When suggesting a new feature, please include as much information as possible, including:
+## 4. AI-assisted code is fine — understood code is required
 
-- A clear and descriptive title
-- A description of the feature
-- The problem the feature will solve
-- Any relevant screenshots or mockups
-- Any relevant links or resources
+Don't commit code you couldn't have written, debugged, or defended yourself. Read the diff, run it, and be ready to explain it in review.
 
-<br>
+## 5. Update docs for API changes
 
-# Contribute code
+If you change puter-js APIs (drivers or endpoints used by puter-js), update [developer docs](src/docs/). puter-js itself may also need updating.
 
-If you'd like to contribute code to Puter, you need to fork the project and submit a pull request. If this is your first time contributing to an open-source project, we recommend reading this short guide by GitHub on [how to contribute to a project](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project).
+## 6. Boy Scout Rule — leave it 1% better
 
-We'll review your pull request and work with you to get your changes merged into the project.
+![Boy Scout Rule](https://imgs.search.brave.com/DMmIWl5-NuZVtrR9kXBb06AKF8kturkgSW9UMb2-6m4/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9sYXdz/b2Zzb2Z0d2FyZWVu/Z2luZWVyaW5nLmNv/bS9pbWFnZXMvbGF3/cy9ib3ktc2NvdXQt/cnVsZS5wbmc)
 
-## Your first code contribution
+Fix the typo, the dead import, the missing test, the bit you had to read twice. Keep cleanup proportional to the change — no refactors riding along on bug fixes.
 
-We maintain a list of issues that are good for first-time contributors. You can find these issues by searching for the [`good first issue`](https://github.com/HeyPuter/puter/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) label in our [GitHub repository](https://github.com/HeyPuter/puter). These issues are designed to be relatively easy to fix, and we're happy to help you get started. Pick an issue that interests you, and leave a comment on the issue to let us know you're working on it.
+---
 
-<br>
+## Opening a PR
 
-## Documentation for Contributors
+- One thing per PR where possible.
+- Describe **what** and **why**; the diff shows how.
+- Mention how you tested user-visible changes.
+- Drafts welcome.
 
-See [doc/contributors/index.md](./doc/contributors/index.md) for more information.
+---
 
-<br>
-
-## Commit Messages
-
-Use the imperative, as is the convention in the Linux kernel:
-
-- correct: `Improve performance of readdir`
-- incorrect: `Improved readdir`
-- incorrect: `Improving readdir`
-
-We have the following exceptions to this rule:
-- If the commit message is in _past tense_, it's a shorthand for the following:
-  - `Apply changes that would be applied after one had <past tense message>`
-- If the commit message is in _present tense_, it's shorthand for the following:
-  - `Apply changes that would be applied after <present-tense message>`
-
-For example, the following are correct:
-- `Improved readdir`
-  - interpret this as: `Apply changes that would be applied after one had improved readdir`
-- `Improving readdir`
-  - interpret this as: `Apply changes that would be applied after improving readdir`
-
-<br>
-
-## Code Review
-
-Once you've submitted your pull request, the project maintainers will review your changes. We may suggest some changes or improvements. This is a normal part of the process, and your contributions are greatly appreciated!
-
-<br>
-
-## Contribution License Agreement (CLA)
-
-Like many open source projects, we require contributors to sign a Contribution License Agreement (CLA) before we can accept your code. When you open a pull request for the first time, a bot will automatically add a comment with a link to the CLA. You can sign the CLA electronically by following the link and filling out the form.
-
-<br>
-
-# Getting Help
-
-If you have any questions about Puter, please feel free to reach out to us through the following channels:
-
-- [Discord](https://discord.com/invite/PQcx7Teh8u)
-- [Reddit](https://www.reddit.com/r/Puter/)
-- [Twitter](https://twitter.com/HeyPuter)
-- [Email](mailto:[email protected])
+Questions? Message a core maintainer. Welcome aboard.

Dockerfile

@@ -1,64 +1,88 @@
-# /!\ NOTICE /!\
+# syntax=docker/dockerfile:1.7
+#
+# OSS Puter image — multi-arch (linux/amd64, linux/arm64).
+#
+# Build & push:
+#   docker buildx build --platform linux/amd64,linux/arm64 \
+#       -t ghcr.io/heyputer/puter:latest --push .
+#
+# Local single-arch build:
+#   docker build -t puter .
+#
+# Self-hosters inject configuration by mounting a config.json at
+# /etc/puter/config.json. It is deep-merged over the bundled
+# config.default.json, so partial overrides work. Absent file = defaults.
 
-# Many of the developers DO NOT USE the Dockerfile or image.
-# While we do test new changes to Docker configuration, it's
-# possible that future changes to the repo might break it.
-# When changing this file, please try to make it as resiliant
-# to such changes as possible; developers shouldn't need to
-# worry about Docker unless the build/run process changes.
+# ---- Build stage ----
+FROM node:24-slim AS build
 
-# Build stage
-FROM node:21-alpine AS build
+WORKDIR /opt/puter
 
-# Install build dependencies
-RUN apk add --no-cache git python3 make g++ \
-    && ln -sf /usr/bin/python3 /usr/bin/python
+# Build toolchain needed for native deps (bcrypt, sharp, better-sqlite3, …).
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends python3 make g++ git && \
+    rm -rf /var/lib/apt/lists/*
 
-# Set up working directory
-WORKDIR /app
+ENV HUSKY=0
+ENV npm_config_fund=false
+ENV npm_config_audit=false
 
-# Copy package.json and package-lock.json
-COPY package*.json ./
+# ---- Dependency layer ---------------------------------------------------
+# Copy ONLY package manifests + lockfile first so the npm-install layer
+# stays cached when only source files change.
+COPY package.json package-lock.json ./
+COPY src/backend/package.json src/backend/
+COPY src/gui/package.json src/gui/
+COPY src/puter-js/package.json src/puter-js/package-lock.json src/puter-js/
+COPY src/worker/package.json src/worker/
+COPY src/docs/package.json src/docs/
 
-# Copy the source files
+# extensionSetup.mjs runs as the postinstall hook during npm ci. (No-ops
+# unless any packages/puter/extensions/* gain a package.json.)
+COPY tools/extensionSetup.mjs tools/extensionSetup.mjs
+
+RUN --mount=type=cache,target=/root/.npm \
+    npm ci
+
+# ---- Source layer -------------------------------------------------------
 COPY . .
 
-# Install node modules
-RUN npm cache clean --force \
-    && npm ci
+# Compile backend TS, then build GUI + puter-js webpack bundles in
+# parallel. The GUI/puter-js bundles are how /dist/bundle.min.{js,css}
+# and /sdk/puter.js fall back to local assets when the kernel-config
+# CDN keys are unset.
+RUN npm run build:ts
+RUN set -e; \
+    (cd src/gui && node ./build.js) & gui_pid=$!; \
+    (cd src/puter-js && npm run build) & pjs_pid=$!; \
+    wait $gui_pid; \
+    wait $pjs_pid
 
-# Run the build command if necessary
-RUN npm run build
+# ---- Runtime stage (slim — no build tools) ----
+FROM node:24-slim
 
-# Production stage
-FROM node:21-alpine
+WORKDIR /opt/puter
 
-# Set labels
-LABEL repo="https://github.com/HeyPuter/puter"
-LABEL license="AGPL-3.0,https://github.com/HeyPuter/puter/blob/master/LICENSE.txt"
-LABEL version="1.2.46-beta-1"
+# git: runtime version probe. wget: HEALTHCHECK.
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends git wget && \
+    rm -rf /var/lib/apt/lists/*
 
-# Install git (required by Puter to check version)
-RUN apk add --no-cache git
+COPY --from=build --chown=node:node /opt/puter .
 
-# Set up working directory
-RUN mkdir -p /opt/puter/app
-WORKDIR /opt/puter/app
+RUN mkdir -p /etc/puter /var/puter && \
+    chown -R node:node /etc/puter /var/puter
 
-# Copy built artifacts and necessary files from the build stage
-COPY --from=build /app/dist ./dist
-COPY --from=build /app/node_modules ./node_modules
-COPY . .
-
-# Set permissions
-RUN chown -R node:node /opt/puter/app
-USER node
+# Self-hosters mount their override at this exact path. The v2 loader
+# deep-merges it over config.default.json (see backend/index.ts).
+ENV PUTER_CONFIG_PATH=/etc/puter/config.json
+ENV NODE_OPTIONS=--enable-source-maps
 
 EXPOSE 4100
 
-HEALTHCHECK --interval=30s --timeout=3s \
+USER node
+
+HEALTHCHECK --interval=30s --timeout=3s --start-period=30s --retries=3 \
     CMD wget --no-verbose --tries=1 --spider http://puter.localhost:4100/test || exit 1
 
-ENV NO_VAR_RUNTUME=1
-
-CMD ["npm", "start"]
+CMD ["node", "-r", "./dist/src/backend/telemetry.js", "./dist/src/backend/index.js"]

README.md

@@ -1,41 +1,46 @@
 <h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
 
-<h3 align="center">The Internet OS! Free, Open-Source, and Self-Hostable.</h3>
+<h3 align="center">The Open-Source Internet Computer!</h3>
 
 <p align="center">
-    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <a href="https://puter.com/?ref=github.com"><strong>« LIVE DEMO »</strong></a>
     <br />
     <br />
-    <a href="https://puter.com">Puter.com</a>
+    <a href="https://puter.com/?ref=github.com">Puter.com</a>
     ·
-    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    <a href="https://apps.puter.com/">App Store</a>
+    ·
+    <a href="https://developer.puter.com" target="_blank">Developers</a>
     ·
     <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
     ·
     <a href="https://reddit.com/r/puter">Reddit</a>
     ·
-    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
-    ·
-    <a href="https://hackerone.com/puter_h1b">Bug Bounty</a>
+    <a href="https://twitter.com/HeyPuter">X</a>
 </p>
 
-<h3 align="center"><img width="700" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-2.webp"></h3>
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot.webp"></h3>
 
 <br/>
 
 ## Puter
 
-Puter is an advanced, open-source internet operating system designed to be feature-rich, exceptionally fast, and highly extensible. It can be used to build remote desktop environments or serve as an interface for cloud storage services, remote servers, web hosting platforms, and more.
+Puter is an advanced, open-source, self-hostable internet computer designed to be feature-rich, fast, and highly extensible.
+
+### For Users
+Puter's goal is to provide you with every app and feature you need to work, create, and play under one roof. From a simple [Notepad](https://online-notepad.com) and [Voice Recorder](https://voice-recorder.com) to [Spreadsheet](https://apps.puter.com/app/spreadsheet) and [Camera](https://online-camera.com), Puter wants to be the all-in-one solution for your digital life.
+
+
+### For Developers
+
+Puter provides everything you need to build and publish web apps and games. From [AI](https://developer.puter.com/ai/) to [Cloud Storage](https://developer.puter.com/object-storage/) and [Database](https://developer.puter.com/key-value-database/) to [Serverless Workers](https://developer.puter.com/serverless-workers/), Puter has you covered. Puter also helps you get users! Once you build your app, you can publish it on our [App Store](https://apps.puter.com/) to reach and monetize users.
 
 <br/>
 
 ## Getting Started
 
-After reading this section, please proceed to **Self-Hosting** and **Configuration** below.
-Read these instructions carefully or you may see errors due to
-an invalid setup.
 
-### Local Development
+### 💻 Local Development
 
 ```bash
 git clone https://github.com/HeyPuter/puter
@@ -43,140 +48,89 @@ cd puter
 npm install
 npm start
 ```
+**→** This should launch Puter at  http://puter.localhost:4100
 
-This will launch Puter at http://localhost:4000 (or the next available port).
 
 <br/>
 
-### Using Docker
+### 🚀 Self-Hosting
 
-**note:** it is **not** necessary to run this within a clone of this repository. For contributors, it is recommended to use the [Local Development](#local-development) instructions.
+#### Linux/macOS
 
 ```bash
-mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+curl -fsSL https://puter.com/selfhost | sh
 ```
 
-### Using Docker Compose
+#### Windows
 
-**note:** it is **not** necessary to run this within a clone of this repository. For contributors, it is recommended to use the [Local Development](#local-development) instructions.
-
-```bash
-mkdir -p puter/config puter/data
-sudo chown -R 1000:1000 puter
-wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
-docker compose up
+```powershell
+irm https://puter.com/selfhost?os=windows | iex
 ```
 
-<br/>
-
-See [Configuration](#configuration) for next steps.
+**→** For more details, see [Self-Hosting Puter](./doc/self-hosting.md).
 
 <br/>
 
-## ⚠️ Self-Hosting ⚠️
-The self-hosted version of Puter is currently in alpha stage and should not be used in production yet. It is under active development and may contain bugs, other issues. Please exercise caution and use it for testing and evaluation purposes only.
+### ☁️ Puter.com
+
+Puter is available as a hosted service at [**puter.com**](https://puter.com).
 
 <br/>
 
-## Configuration
+## Support
 
-Running the server will generate a configuration file in one of these locations:
-- `config/config.json` when [Using Docker](#using-docker)
-- `volatile/config/config.json` in [Local Development](#local-development)
-- `/etc/puter/config.json` on a server (or within a Docker container)
+Connect with the maintainers and community through these channels:
 
-### Domain Name
+- Bug report or feature request? Please [open an issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Security issues or abuse reports? [[email protected]](mailto:[email protected])
+- Email maintainers at [[email protected]](mailto:[email protected])
 
-To access Puter on your device, you can simply go to the address printed in
-the server console (usually `puter.localhost:4100`).
-
-To access Puter from another device, a domain name must be configured, as well as
-an `api` subdomain. For example, `example.local` might be the domain name pointing
-to the IP address of the server running puter, and `api.example.com` must point to
-this address as well. This domain must be specified in the configuration file
-(usually `volatile/config/config.json`) as well.
-
-See [domain configuration](./doc/self-hosters/domains.md) for more information.
-
-### Configure the Port
-
-- You can specify a custom port by setting `http_port` to a desired value
-- If you're using a reverse-proxy such as nginx or cloudflare, you should
-  also set `pub_port` to the public (external) port (usually `443`)
-- If you have HTTPS enabled on your reverse-proxy, ensure that
-  `protocol` in config.json is set accordingly
-
-### Default User
-
-By default, Puter will create a user called `default_user`.
-This user will have a randomly generated password, which will be printed
-in the development console.
-A warning will persist in the dev console until this user's
-password is changed. Please login to this user and change the password as
-your first step.
+We are always happy to help you with any questions you may have. Don't hesitate to ask!
 
 <br/>
 
-##  License
+## License
 
-This repository is licensed under AGPL-3.0; However, our SDK (puter.js) is also available under Apache 2.0, as indicated by the license file in that section (packages/puter-js) of this repository.
+This repository, including all its contents, sub-projects, modules, and components, is licensed under [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) unless explicitly stated otherwise. Third-party libraries included in this repository may be subject to their own licenses.
 
 <br/>
 
-## FAQ
+## Translations
 
-### ❓ What's the use case for Puter?
-
-Puter can be used as:
-
-- An alternative to Dropbox, Google Drive, OneDrive, etc. with a fresh interface and powerful features.
-- Remote desktop environment for servers and workstations.
-- A platform for building and hosting websites, web apps, and games.
-- A friendly, open-source project and community to learn about web development, cloud computing, distributed systems, and much more!
-
-<br/>
-
-
-### ❓ Why isn't Puter built with React, Angular, Vue, etc.?
-
-For performance reasons, Puter is built with vanilla JavaScript and jQuery. Additionally, we'd like to avoid complex abstractions and to remain in control of the entire stack, as much as possible.
-
-Also partly inspired by some of our favorite projects that are not built with frameworks: [VSCode](https://github.com/microsoft/vscode), [Photopea](https://www.photopea.com/), and [OnlyOffice](https://www.onlyoffice.com/).
-
-<br/>
-
-### ❓ Why jQuery?
-
-Puter interacts directly with the DOM and jQuery provides an elegant yet powerful API to manipulate the DOM, handle events, and much more. It's also fast, mature, and battle-tested. 
-
-<br/>
-
-## #DoesItRunPuter
-
-- [Minecraft](https://twitter.com/HeyPuter/status/1771957571496092036) | [video](https://www.youtube.com/watch?v=GIowZUXkg5g)
-- [Samsung Watch](https://twitter.com/CharmunkDev/status/1781501714543030554)
-- [PlayStation 4](https://twitter.com/HeyPuter/status/1767978053014270059)
-- [Skyworth TV](https://twitter.com/ericalexdube/status/1767983049277411564)
-- [A Fridge!](https://twitter.com/HeyPuter/status/1778890003797745842)
-- [Oculus Quest 2](https://twitter.com/HeyPuter/status/1768664081756754012)
-- [Tesla Model 3](https://twitter.com/EricLighthall/status/1781479732997214501)
-- [Tesla Model S](https://twitter.com/HeyPuter/status/1767971178864587057)
-- [Tesla Model Y](https://twitter.com/HeyPuter/status/1772858333751636310)
-- [Nintendo Switch](https://twitter.com/HeyPuter/status/1780645795240538518)
-- [Steam Deck](https://twitter.com/everythingSung/status/1782162352403828793)
-
-<br/>
-
-## Credits
-
-The default wallpaper is created by [Milad Fakurian](https://unsplash.com/photos/blue-orange-and-yellow-wallpaper-E8Ufcyxz514) and published on [Unsplash](https://unsplash.com/).
-
-Icons by [Papirus](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme) under GPL-3.0 license.
-
-Icons by [Iconoir](https://iconoir.com/) under MIT license.
-
-Icons by [Elementary Icons](https://github.com/elementary/icons) under GPL-3.0 license.
-
-Icons by [Tabler Icons](https://tabler.io/) under MIT license.
-
-Icons by [bootstrap-icons](https://icons.getbootstrap.com/) under MIT license.
+- [Arabic / العربية](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md)
+- [Armenian / Հայերեն](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hy.md)
+- [Bengali / বাংলা](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.bn.md)
+- [Chinese / 中文](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md)
+- [Danish / Dansk](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.da.md)
+- [English](https://github.com/HeyPuter/puter/blob/main/README.md)
+- [Farsi / فارسی](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fa.md)
+- [Finnish / Suomi](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fi.md)
+- [French / Français](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md)
+- [German /  Deutsch](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md)
+- [Hebrew/ עברית](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.he.md)
+- [Hindi / हिंदी](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hi.md)
+- [Hungarian / Magyar](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hu.md)
+- [Indonesian / Bahasa Indonesia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.id.md)
+- [Italian / Italiano](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.it.md)
+- [Japanese / 日本語](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md)
+- [Korean / 한국어](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ko.md)
+- [Malay / Bahasa Malaysia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.my.md)
+- [Malayalam / മലയാളം](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ml.md)
+- [Polish / Polski](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pl.md)
+- [Portuguese / Português](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pt.md)
+- [Punjabi / ਪੰਜਾਬੀ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pa.md)
+- [Romanian / Română](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ro.md)
+- [Russian / Русский](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md)
+- [Spanish / Español](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md)
+- [Swedish / Svenska](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.sv.md)
+- [Tamil / தமிழ்](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ta.md)
+- [Telugu / తెలుగు](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.te.md)
+- [Thai / ไทย](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.th.md)
+- [Turkish / Türkçe](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.tr.md)
+- [Ukrainian / Українська](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ua.md)
+- [Urdu / اردو](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ur.md)
+- [Vietnamese / Tiếng Việt](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.vi.md)

SECURITY-ACKNOWLEDGEMENTS.md

@@ -3,5 +3,7 @@ We would like to thank the following security researchers for their responsible
 
 # 2024
 
-- Tim Suess: [GitHub](https://github.com/blackfortresslabs) | [Email]([email protected]) | [Website](blackfortresslabs.com)
+- Ritesh Sahu [GitHub](https://github.com/riteshs4hu/) | [X](https://x.com/riteshs4hu) | [Website](https://medium.com/@riteshs4hu)
+- Tim Suess: [GitHub](https://github.com/blackfortresslabs) | [Email]([email protected]) | [Website](https://www.blackfortresslabs.com)
 - xyzeva: [Github](https://github.com/xyzeva) | [Email](mailto:[email protected]) | [Website](https://kibty.town/)
+- Yusuf Kelany: [GitHub](https://github.com/YusufYaser) | [X](https://x.com/RealYusufYaser) | [Website](https://yusufyaser.xyz)

SECURITY.md

@@ -14,7 +14,8 @@ If you believe you've found a security issue in software that is maintained in t
 
 To submit a vulnerability report, please contact us at security@puter.com. Your submission will be reviewed and validated by a member of our team.
 
-**⚠ Please do not report security vulnerabilities through public GitHub issues, discussions, or pull requests. ⚠**
+> [!WARNING]  
+> Please do not report security vulnerabilities through public GitHub issues, discussions, or pull requests.
 
 <br>
 
@@ -37,4 +38,3 @@ Please submit a report to us before engaging in conduct that may be inconsistent
 * Please provide detailed reports with reproducible steps and a clearly defined impact.
 * Include the version number of the vulnerable package in your report
 * Social engineering (e.g. phishing, vishing, smishing) is prohibited.
-

TRADEMARK.md

@@ -0,0 +1,214 @@
+# Trademark Guidelines
+
+Version 1.0 dated January 1, 2025
+
+<img src="https://puter.com/images/logo.png" alt="Puter Technologies Inc. Logo" width="150"/>
+
+<br>
+
+
+This trademark policy was prepared to help you understand how to use the Puter trademarks, service marks and logos with Puter Technologies Inc.'s Puter software.
+
+While some of our software is available under a free and open source software license, that copyright license does not include a license to use our trademark, and this Policy is intended to explain how to use our marks consistent with background law and community expectation.
+
+This Policy covers:
+
+1. Our **word** trademarks and service marks: Puter Technologies Inc., Puter, Puter.com
+2. Our **logos**: The Puter Technologies Inc. logo at the top of this policy
+
+This policy encompasses all trademarks and service marks, whether they are registered or not.
+
+<br>
+<br>
+
+## 1. GENERAL GUIDELINES
+
+Whenever you use one of our marks, you must always do so in a way that does not mislead anyone about what they are getting and from whom. For example, you cannot say you are providing the Puter software when you're providing a modified version of it, because recipients may not understand the differences between your modified versions and our own.
+
+You also cannot use our logo on your website in a way that suggests that your website is an official website or that we endorse your website.
+
+You can, though, say you like the Puter software, that you participate in the Puter community, that you are providing an unmodified version of the Puter software.
+
+You may not use or register our marks, or variations of them as part of your own trademark, service mark, domain name, company name, trade name, product name or service name.
+
+Trademark law does not allow your use of names or trademarks that are too similar to ours. You therefore may not use an obvious variation of any of our marks or any phonetic equivalent, foreign language equivalent, takeoff, or abbreviation for a similar or compatible product or service. We would consider the following too similar to one of our Marks:
+
+- MyPuter
+- PuterFooBar
+
+<br>
+<br>
+
+## 2. ACCEPTABLE USES
+
+<br>
+
+### Distribution of Unmodified Software
+
+When you redistribute an unmodified copy of Puter software, you must retain all trademarks, logos, and notices we have placed on the software to identify its origin. This includes:
+
+* Binary distributions exactly as we provide them
+* Source code distributions exactly as we provide them
+* Documentation and other materials directly from our official repositories
+
+<br>
+
+### Distribution of Modified Software
+
+If you distribute a modified version of Puter software, you:
+
+* Must remove all Puter logos from the modified software
+* May use our word marks (but not logos) to accurately describe the software's origin
+* Must clearly indicate that the software has been modified
+* Must include a notice stating: "This software is a modified version of Puter software and is not endorsed by Puter Technologies Inc."
+
+Example of acceptable description: "This software is derived from Puter software and includes modifications for [describe your changes]."
+
+<br>
+
+### Compatibility Statements
+
+You may use our word marks (but not logos) to accurately describe your software's compatibility with Puter software under these conditions:
+
+* Your statements about compatibility must be accurate and not misleading
+* You must include the following notice: "Puter is a trademark of Puter Technologies Inc. This [product/service] is not affiliated with or endorsed by Puter Technologies Inc."
+* You may not suggest that Puter Technologies Inc. has certified or approved your software
+
+
+<br>
+
+### Products Built for Puter
+
+You may describe your product as working with or being built for Puter if:
+
+* Your product is fully compatible with the documented Puter APIs
+* Your product name follows this format: "[Your Product Name] for Puter"
+* You include this notice in all materials: "Puter is a trademark of Puter Technologies Inc. [Your Product Name] is not affiliated with or endorsed by Puter Technologies Inc."
+* Your branding and marketing materials do not create confusion about the source of your product
+
+<br>
+
+### Open Source Projects
+
+For open source projects that interact with or extend Puter software:
+
+* You may use "puter" as part of your project name only if:
+  * The name is in the format "[descriptor]-puter" (e.g., "auth-puter", "backup-puter")
+  * The project's README clearly states it's not officially associated with Puter
+  * The project maintains compatibility with current Puter APIs
+* You must not use our logos without explicit permission
+* You must include appropriate trademark attribution notices
+
+<br>
+
+### Community Activities
+
+You may use our word marks (but not logos) for non-commercial community activities:
+
+* User groups and meetups focused on Puter software
+* Educational content about Puter software
+* Blog posts, videos, articles, or tutorials about Puter software
+
+Conditions for community use:
+
+* Activities must be non-commercial
+* Any fees charged must only cover actual costs
+* You must include appropriate trademark attribution
+* You must not suggest official endorsement without explicit permission
+
+<br>
+
+### Merchandise and Promotional Items
+
+You may not create merchandise or promotional items bearing our marks without explicit written permission from Puter Technologies Inc.
+
+<br>
+
+### Academic and Research Use
+
+You may use our word marks (but not logos) in:
+
+* Academic papers
+* Research publications
+* Technical documentation
+* Educational materials
+
+Include appropriate citations and trademark attributions in such uses.
+
+<br>
+
+### Online Content and Social Media
+
+When using our marks in online content:
+
+* You may use our word marks in hashtags, handles, or usernames if:
+  * The content is clearly about Puter software
+  * You don't imply official status
+  * You include appropriate trademark attribution
+* You must not register social media accounts that could be confused with official Puter accounts
+
+<br>
+
+### APIs and Development
+
+When developing with Puter APIs:
+
+* You may use our word marks to accurately describe your integration
+* You must not use our marks in a way that suggests your API or service is endorse by
+Puter or provided by Puter
+* You must include appropriate trademark attribution
+
+All uses described above must also comply with the General Guidelines section of this policy and maintain the integrity of our marks as described in the How to Display Our Marks section.
+
+<br>
+
+### No Domain Names
+
+You must not register any domain that includes our word marks or any variant or combination of them.
+
+<br>
+<br>
+
+## 3. HOW TO DISPLAY OUR MARKS
+
+When you have the right to use our mark, here is how to display it.
+
+<br>
+
+### Trademark marking and legends
+
+The first or most prominent mention of a mark on a webpage, document, or documentation should be accompanied by a symbol indicating whether the mark is a registered trademark ("®") or an unregistered trademark ("™"). If you don't know which applies, contact us.
+
+Place the following notice at the foot of the page where you have used the mark: "Puter is trademark of Puter Technologies Inc."
+
+<br>
+
+### Use of trademarks in text
+
+**Always use trademarks in their exact form with the correct spelling, neither abbreviated, hyphenated, or combined with any other word or words.**
+
+Unacceptable: Puter-DB
+
+**Don't pluralize a trademark.**
+
+Unacceptable: I have seventeen Puters running in my lab.
+
+**Always use a trademark as an adjective modifying a noun.**
+
+Unacceptable: This is a Puter.  
+Acceptable: This is a Puter software application.
+
+<br>
+
+### Use of Logos
+
+You may not change any logo except to scale it. This means you may not add decorative elements, change the colors, change the proportions, distort it, add elements, or combine it with other logos.
+
+However, when the context requires the use of black-and-white graphics and the logo is color, you may reproduce the logo in a manner that produces a black-and-white image.
+
+<br>
+<br>
+
+## This Document
+
+These guidelines are based on the Model Trademark Guidelines, available at http://www.modeltrademarkguidelines.org., used under a Creative Commons Attribution 3.0 Unported license: https://creativecommons.org/licenses/by/3.0/deed.en_US.

build.js

@@ -1,3 +0,0 @@
-import { build } from "./utils.js"
-
-build();

config.default.json

@@ -0,0 +1,45 @@
+{
+    "config_name": "oss-default",
+    "env": "dev",
+    "port": 4100,
+    "protocol": "http",
+    "domain": "puter.localhost",
+    "cookie_name": "puter_auth_token",
+    "jwt_secret": "dev-jwt-secret-change-me",
+    "jwt_secret_v2": "dev-jwt-secret-v2-change-me",
+    "allow_v1_tokens": true,
+    "url_signature_secret": "dev-url-signature-secret-change-me",
+    "allow_all_host_values": true,
+    "allow_no_host_header": true,
+    "no_devwatch": false,
+    "enable_public_folders": true,
+    "is_storage_limited": false,
+    "min_pass_length": 6,
+    "static_hosting_domain": "site.puter.localhost",
+    "static_hosting_domain_alt": "host.puter.localhost",
+    "private_app_hosting_domain": "app.puter.localhost",
+    "private_app_hosting_domain_alt": "dev.puter.localhost",
+    "captcha": { "enabled": false },
+    "default_user_group": "78b1b1dd-c959-44d2-b02c-8735671f9997",
+    "default_temp_group": "b7220104-7905-4985-b996-649fdcdb3c8f",
+    "storage_capacity": 104857600,
+    "strict_email_verification_required": false,
+    "gui_assets_root": "./src/gui",
+    "puterjs_root": "./src/puter-js/dist",
+    "builtin_apps": {
+        "dev-center": "./src/dev-center"
+    },
+    "extensions": [
+        "./extensions"
+    ],
+    "database": {
+        "engine": "sqlite",
+        "path": "volatile/runtime/puter-database.sqlite"
+    },
+    "s3": {
+        "localConfig": {
+            "dataDir": "volatile/runtime/fauxqs-data",
+            "s3StorageDir": "volatile/runtime/fauxqs-s3-data"
+        }
+    }
+}

config.template.jsonc

@@ -0,0 +1,356 @@
+{
+    // Comprehensive template — every key the OSS backend or shipped (non-prod)
+    // extensions read. Copy to `config.json` and trim what you don't need;
+    // unset keys fall back to documented defaults. See
+    // `src/backend/types.ts` for the per-field source of truth.
+    //
+    // Each setting lives at exactly one canonical key — there are no fallback
+    // aliases. Values shown are illustrative, not production secrets.
+    //
+    // Keys consumed only by closed-source / hosted-prod extensions (clickhouse,
+    // cacheUpdateHandler, pages, prodMeteringAndBilling, …) are intentionally
+    // omitted.
+
+    // ── Environment / identity ──────────────────────────────────────────
+    "config_name": "template",
+    // `dev` opens a browser on boot, skips blocked-email checks, and runs the
+    // dev-time webpack watcher; `prod` serves pre-built bundles.
+    "env": "dev",
+    "version": "0.0.0",
+    // Stable identity for this server node — used by pager alerts and
+    // graceful-shutdown coordination.
+    "serverId": "node-1",
+
+    // ── Networking / URLs ───────────────────────────────────────────────
+    // Port Puter listens on internally.
+    "port": 4100,
+    // Externally-visible port (set this when behind a reverse proxy on 80/443).
+    "pub_port": 4100,
+    "protocol": "http",
+    "domain": "puter.localhost",
+    // Fully-qualified externally-visible URL. Computed from protocol/domain/
+    // pub_port if unset.
+    "origin": "http://puter.localhost:4100",
+    // Public base URL for the API subdomain (used to build signed URLs and
+    // surfaced to the client by the `installedApps` and `whoami` extensions).
+    "api_base_url": "http://api.puter.localhost:4100",
+    // Subdomains Puter routes on. Wildcard DNS (`*.<domain>`) must point at
+    // this server for site/app hosting to work.
+    "static_hosting_domain": "site.puter.localhost",
+    "static_hosting_domain_alt": "host.puter.localhost",
+    "private_app_hosting_domain": "app.puter.localhost",
+    "private_app_hosting_domain_alt": "dev.puter.localhost",
+    // Host-header / domain handling. Defaults below are the dev-friendly
+    // settings; tighten for any public install.
+    "allow_all_host_values": true,
+    "allow_no_host_header": true,
+    "allow_nipio_domains": false,
+    "custom_domains_enabled": false,
+    "enable_ip_validation": false,
+    // Express `trust proxy` setting — set to the number of reverse-proxy
+    // hops in front of the server (1 = nginx/Cloudflare, 2 = CF→ALB→app),
+    // or to a CIDR / IP / list. `false` (safe default) makes `req.ip` the
+    // direct socket peer. NEVER set to `true` in prod — it trusts every hop
+    // and makes X-Forwarded-For forgeable.
+    "trust_proxy": false,
+    "no_browser_launch": false,
+
+    // ── Dev watcher (devWatcher extension) ──────────────────────────────
+    // Rebuilds GUI + puter.js on file changes when running from source.
+    // Ignored when `env: "prod"` unless `devwatch.enabled: true`.
+    "no_devwatch": false,
+    "devwatch": {
+        // Delay after watcher startup before boot continues. Lets webpack
+        // emit its first build so the homepage doesn't 404 on bundle.min.js.
+        "ready_delay_ms": 5000
+    },
+
+    // ── Auth / session ──────────────────────────────────────────────────
+    // ALWAYS replace these for any public install — `openssl rand -hex 64`.
+    // `jwt_secret` is legacy verify-only; new tokens sign with `jwt_secret_v2`.
+    "jwt_secret": "change-me",
+    "jwt_secret_v2": "change-me",
+    // Set false to retire v1 tokens entirely (ROLLOUT-1).
+    "allow_v1_tokens": true,
+    "url_signature_secret": "change-me",
+    "cookie_name": "puter_auth_token",
+    "min_pass_length": 6,
+    "allow_system_login": false,
+    "strict_email_verification_required": false,
+    "captcha": {
+        "enabled": false,
+        "difficulty": "medium"
+    },
+    "oidc": {
+        "providers": {
+            // Google uses OIDC discovery — only ids are required.
+            "google": {
+                "client_id": "",
+                "client_secret": "",
+                "scopes": "openid email profile"
+            },
+            // Custom OIDC providers must also supply the three endpoints.
+            "custom-oidc": {
+                "client_id": "",
+                "client_secret": "",
+                "authorization_endpoint": "",
+                "token_endpoint": "",
+                "userinfo_endpoint": "",
+                "scopes": "openid email profile"
+            }
+        }
+    },
+
+    // ── Groups / provisioning ───────────────────────────────────────────
+    // UIDs of the persistent groups new users are auto-enrolled in.
+    "default_user_group": "78b1b1dd-c959-44d2-b02c-8735671f9997",
+    "default_temp_group": "b7220104-7905-4985-b996-649fdcdb3c8f",
+    // When true, ACL grants read/list on `/<user>/Public` to any actor.
+    "enable_public_folders": true,
+
+    // ── Storage / S3 ────────────────────────────────────────────────────
+    "s3": {
+        // Local fauxqs (in-process S3-compatible) — used in dev and the
+        // bundled-defaults Docker mode. Files land under `dataDir`.
+        "localConfig": {
+            "inMemory": false,
+            "host": "127.0.0.1",
+            "port": 4566,
+            "dataDir": "volatile/runtime/fauxqs-data",
+            "s3StorageDir": "volatile/runtime/fauxqs-s3-data"
+        },
+        // For real / external S3, replace `localConfig` above with `s3Config`.
+        "_remote_example": {
+            "s3Config": {
+                "useCredentialChain": false,
+                "endpoint": "https://s3.example.com",
+                // Endpoint used in presigned URLs handed to the browser. Set
+                // this when the server-side endpoint isn't reachable from the
+                // browser (e.g. docker-internal `http://s3:9000`).
+                "publicEndpoint": "",
+                "accessKeyId": "",
+                "secretAccessKey": "",
+                "region": "us-west-2",
+                // Set true for RustFS / MinIO / fauxqs (path-style URLs).
+                // Real AWS S3 wants virtual-hosted — leave unset / false.
+                "forcePathStyle": false
+            }
+        }
+    },
+    "s3_bucket": "puter-local",
+    "s3_region": "us-west-2",
+    "region": "us-west-2",
+    // Default per-user storage cap (bytes). 100 MB.
+    "storage_capacity": 104857600,
+    "is_storage_limited": false,
+    "available_device_storage": 0,
+    // ── Thumbnails (thumbnails extension) ───────────────────────────────
+    // Optional dedicated S3-compatible bucket for generated thumbnails.
+    // When unset (or `endpoint` empty), the extension falls back to the
+    // main S3 client / bucket above.
+    "thumbnailStore": {
+        "name": "puter-local",
+        "endpoint": "",
+        "credentials": {
+            "accessKeyId": "",
+            "secretAccessKey": ""
+        }
+    },
+
+    // ── Database ────────────────────────────────────────────────────────
+    "database": {
+        // `sqlite` for single-node / dev; `mysql` for self-host with MariaDB.
+        "engine": "sqlite",
+        // sqlite — file path on disk
+        "path": "volatile/runtime/puter-database.sqlite",
+        "targetVersion": 0,
+        // mysql — connection details
+        "host": "",
+        "port": 3306,
+        "user": "",
+        "password": "",
+        "database": "",
+        // Optional read-replica pool. Reads route here when populated.
+        "replica": {
+            "host": "",
+            "port": 3306,
+            "user": "",
+            "password": "",
+            "database": ""
+        }
+        // mysql self-host bootstrap: set `migrationPaths` to apply the bundled
+        // schema on first boot. Idempotent — safe to leave on.
+        // "migrationPaths": ["./src/backend/clients/database/migrations/mysql"]
+    },
+
+    // ── DynamoDB (KV store) ─────────────────────────────────────────────
+    "dynamo": {
+        // Local emulator (dynamodb-local) endpoint. Drop this field for real
+        // AWS DynamoDB.
+        "endpoint": "http://localhost:8000",
+        // Set true when pointing at a local emulator so Puter creates the KV
+        // table on boot. NEVER set against real AWS — provision via IaC.
+        // "bootstrapTables": true,
+        "path": "",
+        // Credentials. NOTE: snake_case here, unlike `s3.s3Config` below.
+        // For dynamodb-local, any non-empty values work.
+        "aws": {
+            "access_key": "",
+            "secret_key": "",
+            "region": "us-west-2"
+        }
+    },
+
+    // ── Redis / Valkey (cache + cross-node rate limit) ──────────────────
+    "redis": {
+        // True → in-process redis-mock (dev / single-node).
+        "useMock": true,
+        // Cluster nodes for ioredis. For a single Valkey/Redis container,
+        // run it in cluster mode (one node, all slots).
+        "startupNodes": [
+            {
+                "host": "127.0.0.1",
+                "port": 7000
+            }
+        ]
+        // Defaults to true (matches prod ElastiCache). Set false for plain-TCP
+        // self-host Valkey/Redis.
+        // "tls": false
+    },
+
+    // ── Email (transactional) ───────────────────────────────────────────
+    // Nodemailer transport — used for password resets, email confirmation, etc.
+    "email": {
+        "from": "\"Puter\" <[email protected]>",
+        "host": "smtp.example.com",
+        "port": 587,
+        "secure": false,
+        "service": "",
+        "auth": {
+            "user": "",
+            "pass": ""
+        }
+    },
+
+    // ── Rate limiting ───────────────────────────────────────────────────
+    // `memory` for single-node, `redis` for multi-node (default), `kv` for
+    // dynamo-backed counters.
+    "rate_limit": {
+        "backend": "redis"
+    },
+
+    // ── AI / integration providers ──────────────────────────────────────
+    // All AI drivers (chat, image, video, TTS, OCR, STT) read from here.
+    // Provider id == driver-side identifier. Leave empty / omit to disable.
+    "providers": {
+        // ─ Chat / completion ─
+        "claude": { "apiKey": "" },
+        "openai-completion": { "apiKey": "" },
+        "gemini": { "apiKey": "" },
+        "groq": { "apiKey": "" },
+        "deepseek": { "apiKey": "" },
+        "mistral": { "apiKey": "" },
+        "xai": { "apiKey": "" },
+        "moonshot": { "apiKey": "" },
+        "openrouter": {
+            "apiKey": "",
+            "apiBaseUrl": "https://openrouter.ai/api/v1"
+        },
+        "together-ai": { "apiKey": "" },
+        // Local Ollama. `enabled: false` skips the auto-probe at startup
+        // (otherwise Puter logs ECONNREFUSED on every boot when no Ollama
+        // is running).
+        "ollama": {
+            "enabled": false,
+            "apiBaseUrl": "http://localhost:11434"
+        },
+
+        // ─ Image generation ─
+        "openai-image-generation": { "apiKey": "" },
+        "gemini-image-generation": { "apiKey": "" },
+        "together-image-generation": { "apiKey": "" },
+        "cloudflare-image-generation": {
+            "apiToken": "",
+            "accountId": "",
+            "apiBaseUrl": "https://api.cloudflare.com/client/v4"
+        },
+        "xai-image-generation": { "apiKey": "" },
+
+        // ─ Video generation ─
+        "openai-video-generation": { "apiKey": "" },
+        "together-video-generation": { "apiKey": "" },
+        "gemini-video-generation": { "apiKey": "" },
+
+        // ─ Speech / OCR ─
+        "openai": { "apiKey": "" },
+        "elevenlabs": {
+            "apiKey": "",
+            "apiBaseUrl": "https://api.elevenlabs.io",
+            "defaultVoiceId": "",
+            "speechToSpeechModelId": ""
+        },
+        "aws-polly": {
+            "access_key": "",
+            "secret_key": "",
+            "region": "us-west-2"
+        },
+        "aws-textract": {
+            "access_key": "",
+            "secret_key": "",
+            "region": "us-west-2"
+        },
+        "mistral-ocr": { "apiKey": "" }
+    },
+
+    // ── GUI / static mounts ─────────────────────────────────────────────
+    "gui_assets_root": "./src/gui",
+    "gui_profile": "development",
+    "builtin_apps": {
+        "dev-center": "./src/dev-center"
+    },
+    // Force the bundled GUI even in dev — set true when running from a
+    // pre-built tree without webpack-dev-server.
+    "use_bundled_gui": false,
+    "gui_bundle": "/dist/bundle.min.js",
+    "gui_css": "/dist/bundle.min.css",
+    "gui_puterjs_bundle": "https://js.puter.com/v2/",
+    "gui_params": {
+        "title": "Puter",
+        "short_description": "Your personal cloud computer",
+        "social_media_image": ""
+    },
+    // Optional roots for native app bundles and custom puter.js builds.
+    "native_apps_root": "",
+    "client_libs_root": "",
+    "puterjs_root": "./src/puter-js/dist",
+
+    // ── Feature flags (whoami extension) ────────────────────────────────
+    // Flat `{ flag_name: boolean }` bag. Server-only by default — flags are
+    // only surfaced to the client if their key is on the allowlist in
+    // `extensions/whoami.ts` (CLIENT_VISIBLE_FEATURE_FLAGS).
+    "feature_flags": {
+        "example_flag": false
+    },
+
+    // ── Misc / safety ───────────────────────────────────────────────────
+    // TLDs / domains rejected at signup (prod only).
+    "blockedEmailDomains": [],
+    "support_email": "[email protected]",
+    // Worker / subdomain names users can't claim.
+    "reserved_words": [],
+    "max_subdomains_per_user": 10,
+    "server_health": {
+        "db_liveness_latency_fail_ms": 1500,
+        "stale_health_loop_fail_ms": 0
+    },
+
+    // ── Extensions ──────────────────────────────────────────────────────
+    // Directories scanned for extension entrypoints (`*.ts` / subdirs).
+    "extensions": [
+        "./extensions"
+    ],
+
+    // ── Metering ────────────────────────────────────────────────────────
+    // When true, all metering checks pass — no per-actor limits enforced.
+    "unlimitedMetering": false
+}

dev-server.js

@@ -1,58 +0,0 @@
-import express from "express";
-import { generateDevHtml, build } from "./utils.js";
-import { argv } from 'node:process';
-import chalk from 'chalk';
-import dotenv from 'dotenv';
-dotenv.config();
-
-const app = express();
-let port = process.env.PORT ?? 4000; // Starting port
-const maxAttempts = 10; // Maximum number of ports to try
-const env = argv[2] ?? "dev";
-
-const startServer = (attempt, useAnyFreePort = false) => {
-    if (attempt > maxAttempts) {
-        useAnyFreePort = true; // Use any port that is free
-    }
-
-    const server = app.listen(useAnyFreePort ? 0 : port, () => {
-        console.log("\n-----------------------------------------------------------\n");
-        console.log(`Puter is now live at: `, chalk.underline.blue(`http://localhost:${server.address().port}`));
-        console.log("\n-----------------------------------------------------------\n");
-    }).on('error', (err) => {
-        if (err.code === 'EADDRINUSE') { // Check if the error is because the port is already in use
-            console.error(chalk.red(`ERROR: Port ${port} is already in use. Trying next port...`));
-            port++; // Increment the port number
-            startServer(attempt + 1); // Try the next port
-        }
-    });
-};
-
-// Start the server with the first attempt
-startServer(1);
-
-// build the GUI
-build();
-
-app.get(["/", "/app/*", "/action/*"], (req, res) => {
-    res.send(generateDevHtml({
-        env: env,
-        api_origin: "https://api.puter.com",
-        title: "Puter",
-        max_item_name_length: 150,
-        require_email_verification_to_publish_website: false,
-        short_description: `Puter is a privacy-first personal cloud that houses all your files, apps, and games in one private and secure place, accessible from anywhere at any time.`,
-    }));
-})
-app.use(express.static('./'));
-
-if(env === "prod"){
-    // make sure to serve the ./dist/ folder maps to the root of the website
-    app.use(express.static('./dist/'));
-}
-
-if(env === "dev"){
-    app.use(express.static('./src/'));
-}
-
-export { app };

doc/architecture.md

@@ -0,0 +1,104 @@
+# Backend Architecture
+
+Loosely inspired by the Controller–Service–Repository pattern with dependency injection. The backend is organized as a stack of layers where each layer only depends on the layers beneath it, and `PuterServer` ([src/backend/server.ts](../src/backend/server.ts)) instantiates each layer in order and hands the instances down to the next.
+
+## Layers
+
+```mermaid
+block-beta
+    columns 1
+    REQ["HTTP request"]
+    CTRL["Controllers — route handlers, gates, I/O shaping"]
+    DRV["Drivers (optional) — RPC handlers on /drivers/*"]
+    SVC["Services — business logic, no auth"]
+    STR["Stores — persistence / domain shapes"]
+    CLI["Clients — sql, redis, s3, dynamo, email, …"]
+    CFG["Config — IConfig"]
+
+    REQ --> CTRL
+    CTRL --> DRV
+    DRV --> SVC
+    SVC --> STR
+    STR --> CLI
+    CLI --> CFG
+
+    style REQ fill:#0ea5e9,stroke:#0369a1,color:#fff
+    style CTRL fill:#1d4ed8,stroke:#1e3a8a,color:#fff
+    style DRV fill:#2563eb,stroke:#1e40af,color:#fff
+    style SVC fill:#4f46e5,stroke:#3730a3,color:#fff
+    style STR fill:#7c3aed,stroke:#5b21b6,color:#fff
+    style CLI fill:#9333ea,stroke:#6b21a8,color:#fff
+    style CFG fill:#334155,stroke:#1e293b,color:#fff
+```
+
+Each layer only depends on the layers beneath it, and every dependency is injected through the constructor by `PuterServer`. Extensions sit alongside this stack and can register into any layer — see [Extensions](#extensions) below.
+
+| Layer | Lives in | Responsibility |
+| --- | --- | --- |
+| **Controllers** | [src/backend/controllers/](../src/backend/controllers/) | Route handlers. Parse + validate input, apply per-route gates (auth, subdomain, rate limit, body parsers — see `RouteOptions`), call into services, format responses. |
+| **Drivers** | [src/backend/drivers/](../src/backend/drivers/) | Optional. RPC-style handlers exposed over the `/drivers/*` surface (`puter-kvstore`, `puter-chat-completion`, …). A driver is a thin shell that validates RPC inputs and calls into services/stores; controllers can hold a typed reference to drivers when they need the same logic over HTTP. |
+| **Services** | [src/backend/services/](../src/backend/services/) | Business logic. Assume the caller is already authenticated/authorized — services do not run auth gates themselves. |
+| **Stores** | [src/backend/stores/](../src/backend/stores/) | Persistence and storage logic. Wraps clients with the domain shape services consume (rows, entities, KV namespaces). |
+| **Clients** | [src/backend/clients/](../src/backend/clients/) | Adapters for external/internal services (sql, redis, s3, dynamodb, email, event bus, …). Knows protocols, not domain concepts. |
+| **Config** | `config.*.json` → `IConfig` | The flat, typed config object every layer receives at construction. |
+
+Each layer receives the layers beneath it through its constructor, so dependencies are explicit and traceable from `PuterServer`. A controller does not reach into a client directly; if it needs one, the right move is usually a service.
+
+## Entry point: `PuterServer`
+
+`PuterServer` is the bootstrap. It:
+
+1. Loads any configured extension directories (`config.extensions`) so extensions can register before instantiation begins.
+2. Instantiates each layer in order — clients → stores → services → drivers → controllers — merging in anything extensions have registered for that layer.
+3. Wires global middleware, mounts controller routes through `PuterRouter` (which translates `RouteOptions` into the gate/parser middleware chain), and mounts extension routes through the same materializer.
+4. Fires `onServerStart` hooks across every layer once HTTP is listening, and `onServerPrepareShutdown` / `onServerShutdown` on the way down.
+
+## Context (ALS)
+
+We use [`Context`](../src/backend/core/context.ts) — backed by `AsyncLocalStorage` — to carry per-request state without threading it through every function signature. It is used **sparingly**, mostly for `actor` and `req`. The request-context middleware opens a scope per request after the auth probe runs; anything inside a request handler can call `Context.get('actor')` / `Context.get('req')` instead of plumbing it as an argument.
+
+Prefer explicit arguments. Reach for `Context` only when the value is truly request-scoped and would otherwise need to thread through many layers.
+
+## Extensions
+
+Extensions live alongside core ([packages/puter/extensions/](../extensions/)) and parallel the layered stack. They are meant for **non-crucial parts of the system** — things Puter still works without if removed.
+
+- **Good extensions**: [thumbnails](../extensions/thumbnails.ts), [serverInfo](../extensions/serverInfo.ts), [devWatcher](../extensions/devWatcher.ts) — opt-in features cleanly bolted on.
+- **Should probably be core**: [metering](../extensions/metering.ts), [appTelemetry](../extensions/appTelemetry.ts) — clients now expect these to be present, so the "extension" framing is misleading.
+- **Shouldn't have been an extension**: [whoami](../extensions/whoami.ts) — it's load-bearing for every authenticated client. Keep this one in mind as a cautionary example when deciding whether something belongs in an extension.
+
+### Extension API
+
+The `extension` global ([src/backend/extensions.ts](../src/backend/extensions.ts)) exposes:
+
+- **Layer registration** for first-class additions:
+  - `extension.registerClient(name, ClientClass)`
+  - `extension.registerStore(name, StoreClass)`
+  - `extension.registerService(name, ServiceClass)`
+  - `extension.registerDriver(name, DriverClass)`
+  - `extension.registerController(name, ControllerClass)`
+- **Lightweight wrappers** for the common case where a full class isn't worth it:
+  - `extension.on(event, handler)` — subscribe to event-bus events.
+  - `extension.get(path, opts?, handler)` / `.post` / `.put` / `.delete` / `.patch` / `.head` / `.options` / `.all` / `.use` — register routes. The `opts` shape is the same `RouteOptions` controllers use, so `subdomain`, `requireAuth`, `adminOnly`, body parsers, etc. all work identically.
+- **Cross-layer access**: `extension.import('client' | 'store' | 'service' | 'controller' | 'driver')` returns a lazy proxy to instantiated objects, and `extension.config` exposes the live config.
+
+```ts
+import { extension } from '@heyputer/backend/src/extensions';
+
+const services = extension.import('service');
+
+extension.get('/healthcheck/deep', { subdomain: 'api', adminOnly: true }, async (_req, res) => {
+    res.json({ ok: await services.health.runDeepCheck() });
+});
+
+extension.on('user.signup', (_key, data) => {
+    console.log('new user', data.user.username);
+});
+```
+
+## Conventions
+
+- **TypeScript preferred** in new code where feasible. Existing JS is fine; convert opportunistically when you're already touching a file.
+- **`camelCase`** for variable/function names; **`PascalCase`** for classes and for files that contain a class (`AuthService.ts`, `KVStoreDriver.ts`).
+- **Deduplicate**. If two services need the same logic, lift it into a util/helper rather than calling sideways across the same layer — services should not depend on other services for code reuse.
+- **Don't reach across layers.** Controllers do not poke clients directly; services do not register routes. If you find yourself wanting to, that's usually a signal the abstraction is wrong.

doc/contributors/index.md

@@ -1,25 +0,0 @@
-# Contributing to Puter
-
-## Essential / General Knowledge
-
-### Repository Dichotomy
-
-- Puter's GUI is at the root; `/src` is the GUI
-- Puter's backend is a workspace npm package;
-  it resides in `packages/backend(/src)`
-
-The above may seem counter-intuitive; backend and frontend are siblings, right?
-Consider this: by a different intuition, the backend is at a "deeper" level
-of function; this directory structure better adheres to soon-to-be contributors
-sifting around through the files to discover "what's what".
-
-The directory `volatile` exists _for your convenience_ to simplify running
-Puter for development. When Puter is run
-run with the backend with this repository as its working directory, it
-will use `volatile/config` and `volatile/runtime` instead of
-`/etc/puter` and `/var/puter`.
-
-## See Next
-
-- [Backend Documentation](../../packages/backend/doc/contributors/index.md)
-<!-- - [Frontend Documentation](./frontend.md) -->

doc/i18n/README.ar.md

@@ -0,0 +1,129 @@
+<h3 align="center"><img width="80" alt="Puter.com، الحاسوب السحابي الشخصي: جميع ملفاتك وتطبيقاتك وألعابك في مكان واحد يمكن الوصول إليه من أي مكان في أي وقت." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">نظام تشغيل الإنترنت! مجاني ومفتوح المصدر وقابل للاستضافة الذاتية.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« عرض توضيحي مباشر »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">مجموعة أدوات التطوير</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">ديسكورد</a>
+    ·
+    <a href="https://reddit.com/r/puter">ريديت</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">إكس (تويتر)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="لقطة شاشة" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## بيوتر
+
+<div dir="rtl">
+<p>بيوتر هو نظام تشغيل إنترنت متقدم ومفتوح المصدر، مصمم ليكون غنيًا بالميزات وسريعًا بشكل استثنائي وقابلًا للتوسع بدرجة كبيرة. يمكن استخدام بيوتر كـ:</p>
+
+<ul>
+  <li>سحابة شخصية تعطي الأولوية للخصوصية لحفظ جميع ملفاتك وتطبيقاتك وألعابك في مكان آمن واحد، يمكن الوصول إليه من أي مكان وفي أي وقت.</li>
+  <li>منصة لبناء ونشر المواقع الإلكترونية وتطبيقات الويب والألعاب</li>
+  <li>بديل لـ Dropbox وGoogle Drive وOneDrive وغيرها، مع واجهة جديدة وميزات قوية.</li>
+  <li>بيئة سطح مكتب عن بُعد للخوادم ومحطات العمل.</li>
+  <li>مشروع ومجتمع ودود ومفتوح المصدر للتعلم عن تطوير الويب والحوسبة السحابية والأنظمة الموزعة والكثير غير ذلك!</li>
+</ul>
+</div>
+
+<br/>
+
+## البدء
+
+### 💻 التطوير المحلي
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+سيؤدي هذا إلى تشغيل Puter على http://puter.localhost:4100 (أو المنفذ التالي المتاح).
+
+<br/>
+
+### 🐳 دوكر
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+### 🐙 دوكر كومبوز
+
+#### لينكس/ماك
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+<br/>
+
+#### ويندوز
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+
+<br/>
+
+### ☁️ موقع Puter.com
+
+متاح Puter كخدمة مستضافة على[**puter.com**](https://puter.com)الموقع
+
+<br/>
+
+## متطلبات النظام
+
+- **Operating Systems:** لينكس، ماك، ويندوز
+- **RAM** ٢ جيجابايت كحد أدنى (يوصى بـ ٤ جيجابايت)
+- **Disk Space:** ١ جيجابايت مساحة حرة
+- **Node.js:** الإصدار ١٦+ (يوصى بالإصدار ٢٢+)
+- **npm:** أحدث إصدار مستقر
+
+<br/>
+
+## الدعم
+
+تواصل مع المشرفين والمجتمع من خلال هذه القنوات:
+
+- تقرير عن خطأ أو طلب ميزة؟ الرجاء [فتح مشكلة](https://github.com/HeyPuter/puter/issues/new/choose)
+
+- دسكورد: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- إكس (تويتر): [x.com/HeyPuter](https://x.com/HeyPuter)
+- ريديت: [/reddit.com/r/puter](https://www.reddit.com/r/puter/)
+- ماستودون: [mastodon.social/@puter](https://mastodon.social/@puter)
+- مشاكل أمنية؟ [[email protected]](mailto:[email protected])
+- البريد الإلكتروني للمشرفين [[email protected]](mailto:[email protected])
+
+نحن دائمًا سعداء لمساعدتك في أي أسئلة قد تكون لديك. لا تتردد في السؤال!
+
+<br/>
+
+## الترخيص
+
+هذا المستودع، بما في ذلك جميع محتوياته ومشاريعه الفرعية ووحداته ومكوناته، مرخص تحت [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) ما لم ينص على خلاف ذلك صراحةً. قد تخضع المكتبات الخارجية المدرجة في هذا المستودع لتراخيصها الخاصة.
+
+<br/>

doc/i18n/README.bn.md

@@ -0,0 +1,124 @@
+<h3 align="center"><img width="80" alt="Puter.com, ব্যক্তিগত ক্লাউড কম্পিউটার: আপনার সমস্ত ফাইল, অ্যাপস, এবং গেম এক জায়গায়, যেকোনো সময়, যেকোনো স্থান থেকে অ্যাক্সেসযোগ্য।" src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">ইন্টারনেট ওএস! ফ্রি, ওপেন-সোর্স, এবং সেল্ফ-হোস্টেবল।</h3>
+
+<p align="center">
+    <img alt="GitHub রেপোর আকার " src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub রিলিজ" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub লাইসেন্স" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+
+<p align="center">
+    <a href="https://puter.com/"><strong>« লাইভ ডেমো »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">এসডিকে</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">ডিসকর্ড</a>
+    ·
+    <a href="https://reddit.com/r/puter">রেডিট</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (টুইটার)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="স্ক্রিনশট" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter একটি উন্নত, ওপেন-সোর্স ইন্টারনেট অপারেটিং সিস্টেম যা বৈশিষ্ট্যপূর্ণ, অত্যন্ত দ্রুত এবং উচ্চ মাত্রায় সম্প্রসারণযোগ্য। Puter ব্যবহার করা যেতে পারে:
+
+- একটি প্রাইভেসি-প্রথম পার্সোনাল ক্লাউড হিসাবে যা আপনার সমস্ত ফাইল, অ্যাপস এবং গেমসকে এক জায়গায় নিরাপদে রাখে, যেকোনো সময় যেকোনো স্থান থেকে অ্যাক্সেসযোগ্য।
+- ওয়েবসাইট, ওয়েব অ্যাপ এবং গেম তৈরি ও প্রকাশ করার একটি প্ল্যাটফর্ম হিসাবে।
+- ড্রপবক্স, গুগল ড্রাইভ, ওয়ানড্রাইভ ইত্যাদির বিকল্প হিসাবে একটি নতুন ইন্টারফেস এবং শক্তিশালী বৈশিষ্ট্য সহ।
+- সার্ভার এবং ওয়ার্কস্টেশনের জন্য একটি রিমোট ডেস্কটপ এনভায়রনমেন্ট হিসাবে।
+- ওয়েব ডেভেলপমেন্ট, ক্লাউড কম্পিউটিং, ডিস্ট্রিবিউটেড সিস্টেম এবং আরও অনেক কিছু শিখতে একটি বন্ধুত্বপূর্ণ, ওপেন-সোর্স প্রকল্প এবং কমিউনিটি হিসাবে!
+
+<br/>
+
+## শুরু করার জন্য
+
+## 💻 লোকাল ডেভেলপমেন্ট
+
+```bash
+Copy code
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+এটি Puter কে http://puter.localhost:4100 (অথবা পরবর্তী উপলব্ধ পোর্টে) চালু করবে।
+
+<br/>
+
+## 🐳 ডকার
+
+```bash
+Copy code
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+<br/>
+
+## 🐙 ডকার কম্পোজ
+
+## লিনাক্স/ম্যাকওএস
+
+```bash
+Copy code
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+## উইন্ডোজ
+
+```powershell
+Copy code
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+## ☁️ Puter.com
+Puter [**puter.com**](https://puter.com) এ হোস্টেড সার্ভিস হিসেবে উপলব্ধ।
+
+<br/>
+
+## সিস্টেম রিকোয়ারমেন্টস
+
+- **অপারেটিং সিস্টেম:** লিনাক্স, ম্যাকওএস, উইন্ডোজ
+- **র‍্যাম:** ২জিবি ন্যূনতম (৪জিবি প্রস্তাবিত)
+- **ডিস্ক স্পেস:** ১জিবি ফ্রি স্পেস
+- **Node.js:** সংস্করণ ১৬+ (সংস্করণ ২২+ প্রস্তাবিত)
+- **npm:** সর্বশেষ স্থিতিশীল সংস্করণ
+
+<br/>
+
+## সাপোর্ট
+
+মেইনটেইনার এবং কমিউনিটির সাথে এই চ্যানেলগুলির মাধ্যমে সংযোগ করুন:
+
+- বাগ রিপোর্ট বা ফিচার রিকোয়েস্ট? অনুগ্রহ করে একটি ইস্যু খুলুন।
+- ডিসকর্ড: discord.com/invite/PQcx7Teh8u
+- X (টুইটার): x.com/HeyPuter
+- রেডিট: reddit.com/r/puter/
+- মাস্টডন: mastodon.social/@puter
+- সিকিউরিটি ইস্যু? security@puter.com
+- মেইনটেইনারদের ইমেইল করুন hi@puter.com এ
+
+আপনার যেকোনো প্রশ্নের জন্য আমরা সবসময় সাহায্য করতে প্রস্তুত। জিজ্ঞাসা করতে দ্বিধা করবেন না!
+
+<br/>
+
+## লাইসেন্স
+
+এই রিপোজিটরি, এর সমস্ত বিষয়বস্তু, সাব-প্রকল্প, মডিউল, এবং কম্পোনেন্ট সহ [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) লাইসেন্সের অধীনে লাইসেন্সকৃত, যদি অন্যথায় স্পষ্টভাবে উল্লেখ না করা হয়। এই রিপোজিটরিতে অন্তর্ভুক্ত তৃতীয় পক্ষের লাইব্রেরিগুলি তাদের নিজস্ব লাইসেন্সের অধীনে হতে পারে।
+
+<br/>

doc/i18n/README.da.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, Den Personlige Cloudcomputer: Alle dine filer, apps og spil på ét sted tilgængelige fra hvor som helst til enhver tid." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Internet OS'et! Gratis, Open-Source og kan selvhostes.</h3>
+
+<p align="center">
+    <img alt="GitHub repo størrelse" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Udgivelse" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub Licens" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="skærmbillede" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter er et avanceret, open-source internetoperativsystem designet til at være funktionsrigt, exceptionelt hurtigt og meget udvideligt. Puter kan bruges som:
+
+- En privatlivsfokuseret personlig sky til at opbevare alle dine filer, apps og spil på ét sikkert sted, tilgængeligt hvor som helst og når som helst.
+- En platform til at bygge og publicere hjemmesider, webapplikationer og spil.
+- Et alternativ til Dropbox, Google Drive, OneDrive osv. med et friskt interface og kraftfulde funktioner.
+- Et fjernskrivebordsmiljø for servere og arbejdsstationer.
+- Et venligt, open-source projekt og fællesskab til at lære om webudvikling, cloud computing, distribuerede systemer og meget mere!
+
+<br/>
+
+## Kom godt i gang
+
+
+### 💻 Lokal Udvikling
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Dette vil starte Puter på http://puter.localhost:4100 (eller den næste tilgængelige port).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter er tilgængelig som en hosted tjeneste på [**puter.com**](https://puter.com).
+
+<br/>
+
+## Systemkrav
+
+- **Operativsystemer:** Linux, macOS, Windows
+- **RAM:** 2GB minimum (4GB anbefales)
+- **Diskplads:** 1GB fri plads
+- **Node.js:** Version 16+ (Version 22+ anbefales)
+- **npm:** Seneste stabile version
+
+<br/>
+
+## Support
+
+Kom i kontakt med vedligeholderne og fællesskabet gennem disse kanaler:
+
+- Bugrapport eller funktionønske? Åbn [venligst en sag](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Sikkerhedsspørgsmål? [[email protected]](mailto:[email protected])
+- Send email til vedligeholdere på [[email protected]](mailto:[email protected])
+
+Vi er altid glade for at hjælpe dig med eventuelle spørgsmål, du måtte have. Tøv ikke med at spørge!
+
+<br/>
+
+
+## Licens
+
+Dette repository, inklusive alt dets indhold, underprojekter, moduler og komponenter, er licenseret under [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt), medmindre andet er udtrykkeligt angivet. Tredjepartsbiblioteker inkluderet i dette repository kan være underlagt deres egne licenser.
+
+<br/>

doc/i18n/README.de.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, Der persönliche Cloud-Computer: Alle Ihre Dateien, Apps und Spiele an einem Ort, jederzeit und überall zugänglich." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Das Internet-Betriebssystem! Kostenlos, Open-Source und selbst hostbar.</h3>
+
+<p align="center">
+    <img alt="GitHub Repo-Größe" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Veröffentlichung" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=neueste%20Version"> <img alt="GitHub Lizenz" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="Bildschirmfoto" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter ist ein fortschrittliches, Open-Source-Internet-Betriebssystem, das funktionsreich, außergewöhnlich schnell und hochgradig erweiterbar konzipiert wurde. Puter kann verwendet werden als:
+
+- Eine datenschutzfreundliche persönliche Cloud, um alle Ihre Dateien, Apps und Spiele an einem sicheren Ort aufzubewahren, jederzeit und überall zugänglich.
+- Eine Plattform zum Erstellen und Veröffentlichen von Websites, Webanwendungen und Spielen.
+- Eine Alternative zu Dropbox, Google Drive, OneDrive usw. mit einer frischen Benutzeroberfläche und leistungsstarken Funktionen.
+- Eine Remote-Desktop-Umgebung für Server und Workstations.
+- Ein freundliches, Open-Source-Projekt und eine Community, um mehr über Webentwicklung, Cloud Computing, verteilte Systeme und vieles mehr zu lernen!
+
+<br/>
+
+## Erste Schritte
+
+
+### 💻 Lokale Entwicklung
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Dies startet Puter unter http://puter.localhost:4100 (oder dem nächsten verfügbaren Port).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter ist als gehosteter Dienst unter [**puter.com**](https://puter.com) verfügbar.
+
+<br/>
+
+## Systemanforderungen
+
+- **Betriebssysteme:** Linux, macOS, Windows
+- **RAM:** Mindestens 2GB (4GB empfohlen)
+- **Festplattenspeicher:** 1GB freier Speicherplatz
+- **Node.js:** Version 16+ (Version 22+ empfohlen)
+- **npm:** Neueste stabile Version
+
+<br/>
+
+## Unterstützung
+
+Verbinden Sie sich mit den Maintainern und der Community über diese Kanäle:
+
+- Fehlerbericht oder Funktionsanfrage? Bitte [öffnen Sie ein Issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Sicherheitsprobleme? [[email protected]](mailto:[email protected])
+- E-Mail an die Maintainer: [[email protected]](mailto:[email protected])
+
+Wir helfen Ihnen gerne bei allen Fragen, die Sie haben könnten. Zögern Sie nicht zu fragen!
+
+<br/>
+
+
+## Lizenz
+
+Dieses Repository, einschließlich aller Inhalte, Unterprojekte, Module und Komponenten, ist unter [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) lizenziert, sofern nicht ausdrücklich anders angegeben. In diesem Repository enthaltene Bibliotheken von Drittanbietern können ihren eigenen Lizenzen unterliegen.
+
+<br/>

doc/i18n/README.en.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">The Internet OS! Free, Open-Source, and Self-Hostable.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter is an advanced, open-source internet operating system designed to be feature-rich, exceptionally fast, and highly extensible. Puter can be used as:
+
+- A privacy-first personal cloud to keep all your files, apps, and games in one secure place, accessible from anywhere at any time.
+- A platform for building and publishing websites, web apps, and games.
+- An alternative to Dropbox, Google Drive, OneDrive, etc. with a fresh interface and powerful features.
+- A remote desktop environment for servers and workstations.
+- A friendly, open-source project and community to learn about web development, cloud computing, distributed systems, and much more!
+
+<br/>
+
+## Getting Started
+
+
+### 💻 Local Development
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+This will launch Puter at http://puter.localhost:4100 (or the next available port).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter is available as a hosted service at [**puter.com**](https://puter.com).
+
+<br/>
+
+## System Requirements
+
+- **Operating Systems:** Linux, macOS, Windows
+- **RAM:** 2GB minimum (4GB recommended)
+- **Disk Space:** 1GB free space
+- **Node.js:** Version 16+ (Version 22+ recommended)
+- **npm:** Latest stable version
+
+<br/>
+
+## Support
+
+Connect with the maintainers and community through these channels:
+
+- Bug report or feature request? Please [open an issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Security issues? [[email protected]](mailto:[email protected])
+- Email maintainers at [[email protected]](mailto:[email protected])
+
+We are always happy to help you with any questions you may have. Don't hesitate to ask!
+
+<br/>
+
+
+##  License
+
+This repository, including all its contents, sub-projects, modules, and components, is licensed under [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) unless explicitly stated otherwise. Third-party libraries included in this repository may be subject to their own licenses.
+
+<br/>

doc/i18n/README.es.md

@@ -0,0 +1,171 @@
+<h3 align="center"><img width="80" alt="Puter.com, El Computador Personal en Nube: Todos tus archivos, apps y juegos en un solo lugar accesible desde cualquier lugar en cualquier momento" src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">El Sistema Operativo de Internet! Gratis, de Código abierto, y Autohospedable.</h3>
+
+<p align="center">
+    <a href="https://puter.com/"><strong>« DEMO EN VIVO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://apps.puter.com/">App Store</a>
+    ·
+    <a href="https://developer.puter.com" target="_blank">Developers</a>
+    ·
+    <a href="https://github.com/heyputer/puter-cli" target="_blank">CLI</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://x.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter es un sistema operativo en internet avanzado y de código abierto, diseñado para ser rico en funcionalidades, excepcionalmente rápido y altamente extensible. Puter puede ser usado como:
+
+- Una nube personal privada para almacenar todos tus archivos, aplicaciones y juegos en un lugar seguro, accesible y desde cualquier lugar en cualquier momento.
+- Una plataforma para construir y publicar páginas web, aplicativos sobre la web y juegos.
+- Una alternativa a Dropbox, Google Drive, OneDrive, etc. con una interfaz fresca y llena de funcionalidades.
+- Un entorno de escritorio remoto para servidores y estaciones de trabajo.
+- Un proyecto y comunidad abiertas y amigables para aprender sobre desarrollo web, computación en la nube, sistemas distribuidos y mucho más!
+
+<br/>
+
+## Primeros Pasos
+
+
+### 💻 Desarrollo Local
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+✨ Esto ejecutará Puter en http://puter.localhost:4100 (o el siguiente puerto disponible).
+
+Si esto no funciona, consulta [First Run Issues](./doc/self-hosters/first-run-issues.md) para obtener pasos de solución de problemas.
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+✨ Esto ejecutará Puter en http://puter.localhost:4100 (o el siguiente puerto disponible).
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+✨ Esto ejecutará Puter en http://puter.localhost:4100 (o el siguiente puerto disponible).
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+✨ Esto ejecutará Puter en http://puter.localhost:4100 (o el siguiente puerto disponible).
+
+<br/>
+
+### 🚀 Auto-Hospedaje
+
+Para guías detalladas sobre cómo auto-hospedar Puter, incluyendo opciones de configuración y mejores prácticas, consulta nuestra [Documentación de Auto-Hospedaje](https://github.com/HeyPuter/puter/blob/main/doc/self-hosters/instructions.md).
+
+### ☁️ Puter.com
+
+Puter está disponible como servicio alojado en [**puter.com**](https://puter.com).
+
+<br/>
+
+## Requerimientos del sistema
+
+- **Sistemas operativos:** Linux, macOS, Windows
+- **RAM:** 2GB mínimo (4GB recomendados)
+- **Almacenamiento:** 1GB de espacio libre
+- **Node.js:** Versión 16+ (Versión 23+ recomendada)
+- **npm:** Última version estable
+
+<br/>
+
+## Soporte
+
+Conéctate con los mantenedores y la comunidad a través de estos canales:
+
+- Reporte de bug o solicitud de funcionalidad? Por favor [abrir un issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Problemas de seguridad? [[email protected]](mailto:[email protected])
+- Envia un email a los mantenedores en [[email protected]](mailto:[email protected])
+
+Estamos siempre felices de ayudar con cualquier pregunta que puedas tener. No dudes en preguntar!
+
+<br/>
+
+
+##  Licencia
+
+Este repositorio, incluyendo todo su contenido, sub-proyectos, modulos y componentes, esta licenciado bajo [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) a menos que se indique explícitamente lo contrario. Librerías de terceros incluidos en este repositorio pueden estar sujetas a sus propias licencias.
+
+<br/>
+
+## Traducciones
+
+- [Arabic / العربية](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md)
+- [Armenian / Հայերեն](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hy.md)
+- [Bengali / বাংলা](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.bn.md)
+- [Chinese / 中文](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md)
+- [Danish / Dansk](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.da.md)
+- [English](https://github.com/HeyPuter/puter/blob/main/README.md)
+- [Farsi / فارسی](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fa.md)
+- [Finnish / Suomi](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fi.md)
+- [French / Français](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md)
+- [German/ Deutsch](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md)
+- [Hebrew/ עברית](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.he.md)
+- [Hindi / हिंदी](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hi.md)
+- [Hungarian / Magyar](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hu.md)
+- [Indonesian / Bahasa Indonesia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.id.md)
+- [Italian / Italiano](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.it.md)
+- [Japanese / 日本語](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md)
+- [Korean / 한국어](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ko.md)
+- [Malayalam / മലയാളം](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ml.md)
+- [Polish / Polski](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pl.md)
+- [Portuguese / Português](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pt.md)
+- [Romanian / Română](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ro.md)
+- [Russian / Русский](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md)
+- [Spanish / Español](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md)
+- [Swedish / Svenska](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.sv.md)
+- [Tamil / தமிழ்](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ta.md)
+- [Telugu / తెలుగు](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.te.md)
+- [Thai / ไทย](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.th.md)
+- [Turkish / Türkçe](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.tr.md)
+- [Ukrainian / Українська](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ua.md)
+- [Urdu / اردو](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ur.md)
+- [Vietnamese / Tiếng Việt](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.vi.md)

doc/i18n/README.fa.md

@@ -0,0 +1,133 @@
+<h3 align="center"><img width="80" alt="Puter.com، رایانش ابری شخصی: همه فایل‌ها، برنامه‌ها و بازی‌های شما در یک مکان قابل دسترسی از هر جا و در هر زمان." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">سیستم‌عامل اینترنت! رایگان، متن‌باز، و قابل میزبانی شخصی.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« نسخه نمایشی زنده »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">مستندات توسعه‌دهندگان</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">دیسکورد</a>
+    ·
+    <a href="https://reddit.com/r/puter">ردیت</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">ایکس (توییتر)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="عکس صفحه" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## پیوتر
+
+<div dir="rtl">
+<p>پیوتر یک سیستم عامل تحت وب پیشرفته‌ی متن‌باز است که به منظور ایجاد ویژگی‌های متنوع، سرعت بسیار بالا، و مقیاس‌پذیری طراحی شده است. از پیوتر می‌توان به‌عنوان:</p>
+
+<ul>
+  <li>یک فضای ابری شخصی که بر حریم خصوصی تمرکز دارد و تمام فایل‌ها، برنامه‌ها، و بازی‌های شما را در یک مکان امن ذخیره می‌کند، قابل دسترسی از هر جا و در هر زمان.</li>
+  <li>پلتفرمی برای ساخت و انتشار وب‌سایت‌ها، اپلیکیشن‌های وب، و بازی‌ها.</li>
+  <li>جایگزینی برای Dropbox، Google Drive، OneDrive، و سایر موارد، با یک رابط کاربری مدرن و قابلیت‌های قدرتمند.</li>
+  <li>یک محیط دسکتاپ از راه دور برای سرورها و ایستگاه‌های کاری.</li>
+  <li> یک پروژه و جامعه‌ی متن‌باز دوستانه برای یادگیری توسعه وب، رایانش ابری، سیستم‌های توزیع‌شده، و موارد دیگر نام برد!</li>
+</ul>
+</div>
+
+<br/>
+
+## نحوه‌ی استفاده
+
+### 💻 توسعه‌ی محلی
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+این کار پیوتر را در http://puter.localhost:4100 (یا پورت در دسترس بعدی) اجرا می‌کند.
+
+<br/>
+
+### 🐳 داکر
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 داکر کامپوز
+
+
+#### لینوکس/مک
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### ویندوز
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ وبگاه Puter.com
+
+پیوتر به‌عنوان یک سرویس میزبانی‌شده در وبگاه [**puter.com**](https://puter.com) موجود است.
+
+
+## پیش‌نیازهای سیستم
+
+- **سیستم‌عامل‌ها:** لینوکس، مک، ویندوز
+- **RAM** حداقل ۲ گیگابایت (پیشنهاد: ۴ گیگابایت)
+- **فضای دیسک:** ۱ گیگابایت فضای خالی
+- **Node.js:** نسخه ۱۶+ (پیشنهاد: نسخه ۲۲+)
+- **npm:** آخرین نسخه پایدار
+
+<br/>
+
+## پشتیبانی
+
+با مدیران و انجمن از طریق این کانال‌ها در تماس باشید:
+
+- گزارش اشکال یا درخواست ویژگی؟ لطفاً [Isuue باز کنید](https://github.com/HeyPuter/puter/issues/new/choose)
+    
+- دیسکورد: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+    
+- ایکس (توییتر): [x.com/HeyPuter](https://x.com/HeyPuter)
+    
+- ردیت: [/reddit.com/r/puter](https://www.reddit.com/r/puter/)
+    
+- ماستودون: [mastodon.social/@puter](https://mastodon.social/@puter)
+    
+- مشکلات امنیتی؟ [[email protected]](mailto:[email protected])
+    
+- ایمیل مدیران: [[email protected]](mailto:[email protected])
+    
+
+ما همیشه از پاسخگویی به سوالات شما خرسند هستیم. در سوال پرسیدن درنگ نکنید!
+
+## گواهی
+
+این مخزن، شامل تمام محتویات، پروژه‌های فرعی، ماژول‌ها و اجزای آن، تحت مجوز [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) است مگر آنکه خلاف آن به‌طور صریح ذکر شده باشد. کتابخانه‌های خارجی ممکن است گواهی‌های جداگانه داشته باشند.
+
+<br/> 

doc/i18n/README.fi.md

@@ -0,0 +1,126 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+<h3 align="center">Internetin käyttöjärjestelmä! Ilmainen, avoimen lähdekoodin ja itse isännöitävä.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=viimeisin%20versio"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="näyttökuva" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter on kehittynyt, avoimen lähdekoodin internetin käyttöjärjestelmä, joka on suunniteltu olemaan ominaisuuksiltaan rikas, poikkeuksellisen nopea ja erittäin laajennettava. Puteria voidaan käyttää:
+
+- Yksityisyyttä kunnioittavana henkilökohtaisena pilvenä, johon voit tallentaa kaikki tiedostosi, sovelluksesi ja pelisi turvallisesti yhdessä paikassa, josta ne ovat saatavilla missä tahansa ja milloin tahansa.
+- Alustana verkkosivustojen, web-sovellusten ja pelien rakentamiseen ja julkaisemiseen.
+- Vaihtoehtona Dropboxille, Google Drivelle, OneDrivelle jne. tuoreella käyttöliittymällä ja tehokkailla ominaisuuksilla.
+- Etätyöpöytäympäristönä palvelimille ja työasemille.
+- Ystävällisenä, avoimen lähdekoodin projektina ja yhteisönä, jossa voit oppia verkkokehityksestä, pilvipalveluista, hajautetuista järjestelmistä ja paljon muusta!
+
+<br/>
+
+## Aloittaminen
+
+
+### 💻 Paikallinen kehitys
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Tämä käynnistää Puterin osoitteessa http://puter.localhost:4100 (tai seuraavassa vapaassa portissa).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter on saatavilla isännöitynä palveluna osoitteessa [**puter.com**](https://puter.com).
+
+<br/>
+
+## Järjestelmävaatimukset
+
+- **Käyttöjärjestelmät:** Linux, macOS, Windows
+- **RAM:** Vähintään 2GB (Suositeltu 4GB)
+- **Levytila:** 1GB vapaata tilaa
+- **Node.js:** Versio 16+ (Suositeltu versio 22+)
+- **npm:** Uusin vakaa versio
+
+<br/>
+
+## Tuki
+
+Ota yhteyttä ylläpitäjiin ja yhteisöön näiden kanavien kautta:
+
+- Onko sinulla virheraportti tai ominaisuuspyyntö? Ole hyvä ja [avaa uusi issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Turvallisuusongelmat? [[email protected]](mailto:[email protected])
+- Ota yhteyttä ylläpitäjiin sähköpostitse osoitteessa [[email protected]](mailto:[email protected])
+
+Olemme aina valmiita auttamaan sinua kaikissa kysymyksissäsi. Älä epäröi kysyä!
+
+<br/>
+
+
+##  Lisenssi
+
+Tämä repository, mukaan lukien kaikki sen sisältö, aliprojektit, moduulit ja komponentit, on lisensoitu [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt)-lisenssillä, ellei toisin mainita. Tämän repositoryn mukana tulevat kolmannen osapuolen kirjastot voivat olla omien lisenssiensä alaisia.
+
+<br/>

doc/i18n/README.fr.md

@@ -0,0 +1,125 @@
+<h3 align="center"><img width="80" alt="Puter.com, L'ordinateur cloud personnel : Tous vos fichiers, applications et jeux en un seul endroit accessible de partout à tout moment." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">L'OS Internet ! Gratuit, open-source et auto-hébergeable.</h3>
+
+<p align="center">
+    <img alt="Taille du dépôt GitHub" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="Version GitHub" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=derni%C3%A8re%20version"> <img alt="Licence GitHub" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« DÉMO EN DIRECT »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="capture d'écran" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter est un système d'exploitation internet avancé, open-source, conçu pour être riche en fonctionnalités, extrêmement rapide et hautement extensible. Puter peut être utilisé comme :
+
+- Un cloud personnel axé sur la confidentialité pour garder tous vos fichiers, applications et jeux en un seul endroit sécurisé, accessible de partout à tout moment.
+- Une plateforme pour créer et publier des sites web, des applications web et des jeux.
+- Une alternative à Dropbox, Google Drive, OneDrive, etc. avec une interface renouvelée et des fonctionnalités puissantes.
+- Un environnement de bureau à distance pour serveurs et stations de travail.
+- Un projet et une communauté open-source accueillants pour apprendre le développement web, l'informatique en nuage, les systèmes distribués, et bien plus encore !
+
+<br/>
+
+## Démarrage
+
+
+### 💻 Développement Local
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Cela lancera Puter à http://puter.localhost:4100 (ou au port disponible suivant).
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+<br/>
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter est disponible en tant que service hébergé sur [**puter.com**](https://puter.com).
+
+<br/>
+
+## Configuration système requise
+- **Systèmes d'exploitation:** Linux, macOS, Windows
+- **RAM:** Minimum 2 Go (4 Go recommandés)
+- **Espace disque:** 1 Go d'espace libre
+- **Node.js:** Version 16+ (Version 22+ recommandée)
+- **npm:** Dernière version stable
+
+<br/>
+
+## Support
+
+Connectez-vous avec les mainteneurs et la communauté via ces canaux :
+
+- Un bug ou une demande de fonctionnalité ? Veuillez  [ouvrir une issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Problèmes de sécurité ? [[email protected]](mailto:[email protected])
+- Email des mainteneurs à [[email protected]](mailto:[email protected])
+
+Nous sommes toujours heureux de vous aider avec toutes les questions que vous pourriez avoir. N'hésitez pas à nous demander !
+
+<br/>
+
+
+##  License
+
+Ce dépôt, y compris tout son contenu, sous-projets, modules et composants, est licencié sous [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) sauf indication contraire explicite. Les bibliothèques tierces incluses dans ce dépôt peuvent être soumises à leurs propres licences.
+
+<br/>
+

doc/i18n/README.he.md

@@ -0,0 +1,130 @@
+<h3 align="center"><img width="80" alt="Puter.com, 
+הענן הפרטי: כל הקבצים, האפליקציות והמשחקים שלך במקום אחד נגיש מכל מקום ובכל זמן." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center" dir="rtl">מערכת ההפעלה של האינטרנט! חינמית, קוד פתוח וניתנת לאחסון עצמאי.</h3>
+
+<p align="center">
+    <img alt="GitHub גודל ספרית" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub גרסא" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub רישיון" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« הדגמה לייב »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="צילום מסך" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+<div dir="rtl">
+    <p div="rtl">
+    מערכת ההפעלה Puter הינה ספרית קוד פתוח, מתקדמת, עשירה בתכנים, מהירה במיוחד וניתנת להרחבה.
+    אפשר להישתמש ב Puter כ:</p>
+    <ul>
+        <li>ענן אישי עם פרטיות מקסימלית, לשמירת הקבצים, האפליקציות והמשחקים שלך במקום מאובטח אחד, נגיש מכל מקום ובכל זמן.</li>
+        <li>פלטפורמה לבניית ופרסום אתרים, אפליקציות ומשחקים.</li>
+        <li>אלטרנטיבה ל-Dropbox, Google Drive, OneDrive וכו' עם ממשק מרענן ותכנים חזקים.</li>
+        <li>סביבה לעבודה מרחוק לשרתים ותחנות עבודה.</li>
+        <li>פרוייקט ידידותי, קוד פתוח וקהילה ללמידה על פיתוח אינטרנט, פיתוח בענן, מערכות מבוזרות ועוד הרבה!</li>
+    <ul>
+</div>
+
+<br/>
+
+## בוא נתחיל
+
+### 💻 פיתוח מקומי (Localhost)
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+פקודה זו תפעיל את Puter בכתובת http://puter.localhost:4100 (או בפורט הפנוי הבא).
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+<br/>
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+
+<br/>
+
+### ☁️ Puter.com
+
+מערכת ההפעלה Puter זמינה כשירות אחסון ב- [**puter.com**](https://puter.com).
+
+<br/>
+
+## דרישות מערכת
+
+- **מערכות הפעלה:** Linux, macOS, Windows
+- **RAM:** לפחות 2GB, מומלץ 4GB
+- **מקום פנוי בדיסק:** 1GB
+- **Node.js:** גרסה 16+ (מומלץ גרסה 22+)
+- **npm:** הגרסה היציבה האחרונה
+
+<br/>
+
+## תמיכה
+
+צור קשר עם המפתחים והקהילה דרך הערוצים הבאים:
+
+- דיווח על באג או בקשה לתוכן? אנא [פתח פניה](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter](https://www.reddit.com/r/puter.)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- בעיות אבטחה? [[email protected]](mailto:[email protected])
+- שלח אימייל למפתחים ב [[email protected]](mailto:[email protected])
+
+אנחנו תמיד שמחים לעזור עם כל שאלה שיש. אל תהסס לשאול!
+
+<br/>
+
+## רישיון
+
+ספריה זו, כולל כל התכנים שלה, תתי הפרויקטים, המודולים והרכיבים שלה, מורשית תחת [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) אלא אם נאמר אחרת במפורש. לספריות צד שלישי הכלולות בספרייה זו עשויות להיות רישיונות משלהן.
+
+<br/>

doc/i18n/README.hi.md

@@ -0,0 +1,182 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: आपकी सारी फाइलें, ऐप्स, और गेम एक ही जगह, जिसे कहीं से भी कभी भी एक्सेस किया जा सकता है।" src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">इंटरनेट ओएस! फ्री, ओपन-सोर्स, और सेल्फ-होस्टेबल।</h3>
+
+<p align="center">
+    <a href="https://puter.com/?ref=github.com"><strong>« लाइव डेमो »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com/?ref=github.com">Puter.com</a>
+    ·
+    <a href="https://apps.puter.com/">ऐप स्टोर</a>
+    ·
+    <a href="https://developer.puter.com" target="_blank">डेवलपर्स</a>
+    ·
+    <a href="https://github.com/heyputer/puter-cli" target="_blank">CLI</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter क्या है?
+
+Puter एक एडवांस्ड, ओपन-सोर्स इंटरनेट ऑपरेटिंग सिस्टम है जिसे फीचर-रिच, तेज़ और एक्सटेंडेबल बनाने के लिए डिज़ाइन किया गया है। Puter का उपयोग आप निम्नलिखित चीजों के लिए कर सकते हैं:
+
+- एक प्राइवेसी-फर्स्ट पर्सनल क्लाउड, जो आपकी सभी फाइलों, ऐप्स और गेम्स को एक सेफ जगह पर रखता है, जिसे आप कहीं से भी कभी भी एक्सेस कर सकते हैं।
+- वेबसाइट्स, वेब ऐप्स और गेम्स बनाने और पब्लिश करने का एक प्लेटफ़ॉर्म।
+- Dropbox, Google Drive, OneDrive आदि का एक शानदार और पावरफुल इंटरफ़ेस वाला विकल्प।
+- सर्वर और वर्कस्टेशन के लिए एक रिमोट डेस्कटॉप एनवायरनमेंट।
+- एक फ्रेंडली ओपन-सोर्स प्रोजेक्ट और कम्युनिटी, जहां आप वेब डेवलपमेंट, क्लाउड कंप्यूटिंग, डिस्ट्रीब्यूटेड सिस्टम्स और बहुत कुछ सीख सकते हैं।
+
+<br/>
+
+## शुरुआत कैसे करें?
+
+### 💻 लोकल डेवलपमेंट
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+✨ यह Puter को  
+<font color="red"> http://puter.localhost:4100 </font> (या अगले उपलब्ध पोर्ट) पर लॉन्च करेगा।
+
+
+अगर यह काम नहीं करता, तो [First Run Issues](./doc/self-hosters/first-run-issues.md) देखें।
+
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+✨ यह Puter को 
+<font color="red"> http://puter.localhost:4100</font> (या अगले उपलब्ध पोर्ट) पर लॉन्च करेगा।
+
+<br/>
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+✨ यह <font color="red"> http://puter.localhost:4100  </font>
+ (या अगले उपलब्ध पोर्ट) पर उपलब्ध होगा।
+
+<br/>
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+
+✨ यह Puter को 
+<font color="red"> http://puter.localhost:4100 (or the next available port). </font> (या अगले उपलब्ध पोर्ट) पर लॉन्च करेगा।
+
+<br/>
+
+### 🚀 सेल्फ-होस्टिंग
+
+सेल्फ-होस्टिंग के लिए विस्तृत गाइड, कॉन्फ़िगरेशन ऑप्शन्स और बेस्ट प्रैक्टिसेज जानने के लिए हमारी [Self-Hosting Documentation](https://github.com/HeyPuter/puter/blob/main/doc/self-hosters/instructions.md) देखें।
+
+<br/>
+
+### ☁️ Puter.com
+
+Puter [**puter.com**](https://puter.com) पर एक होस्टेड सर्विस के रूप में भी उपलब्ध है।
+
+<br/>
+
+## सिस्टम आवश्यकताएँ
+
+* **ऑपरेटिंग सिस्टम्स:** Linux, macOS, Windows
+* **RAM:** कम से कम 2GB (4GB रिकमेंडेड)
+* **डिस्क स्पेस:** 1GB फ्री स्पेस
+* **Node.js:** वर्जन 16+ (वर्जन 23+ रिकमेंडेड)
+* **npm:** लेटेस्ट स्टेबल वर्जन
+
+<br/>
+
+## सपोर्ट
+
+नीचे दिए गए माध्यमों से आप मेंटेनर्स और कम्युनिटी से जुड़ सकते हैं:
+
+* बग रिपोर्ट या फीचर रिक्वेस्ट? [यहाँ issue खोलें](https://github.com/HeyPuter/puter/issues/new/choose)।
+* Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+* X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+* Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+* Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+* सिक्योरिटी इशूज़? [[email protected]](mailto:[email protected])
+* ईमेल करें: [[email protected]](mailto:[email protected])
+
+आपके किसी भी सवाल में मदद करने के लिए हम हमेशा तैयार हैं!
+
+<br/>
+
+## लाइसेंस
+
+यह रिपॉज़िटरी और इसके सभी कंटेंट्स [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) लाइसेंस के अंतर्गत आते हैं जब तक कि कुछ और स्पष्ट रूप से ना लिखा हो। इसमें शामिल थर्ड-पार्टी लाइब्रेरीज़ अपने-अपने लाइसेंस के अधीन हो सकती हैं।
+
+<br/>
+
+## अनुवाद
+
+Puter के डॉक्यूमेंटेशन कई भाषाओं में उपलब्ध हैं, जिनमें शामिल हैं:
+
+- [Arabic / العربية](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md)
+- [Armenian / Հայերեն](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hy.md)
+- [Bengali / বাংলা](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.bn.md)
+- [Chinese / 中文](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md)
+- [Danish / Dansk](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.da.md)
+- [English](https://github.com/HeyPuter/puter/blob/main/README.md)
+- [Farsi / فارسی](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fa.md)
+- [Finnish / Suomi](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fi.md)
+- [French / Français](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md)
+- [German/ Deutsch](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md)
+- [Hebrew/ עברית](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.he.md)
+- [Hindi / हिंदी](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hi.md)
+- [Hungarian / Magyar](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hu.md)
+- [Indonesian / Bahasa Indonesia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.id.md)
+- [Italian / Italiano](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.it.md)
+- [Japanese / 日本語](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md)
+- [Korean / 한국어](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ko.md)
+- [Malayalam / മലയാളം](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ml.md)
+- [Polish / Polski](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pl.md)
+- [Portuguese / Português](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pt.md)
+- [Romanian / Română](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ro.md)
+- [Russian / Русский](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md)
+- [Spanish / Español](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md)
+- [Swedish / Svenska](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.sv.md)
+- [Tamil / தமிழ்](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ta.md)
+- [Telugu / తెలుగు](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.te.md)
+- [Thai / ไทย](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.th.md)
+- [Turkish / Türkçe](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.tr.md)
+- [Ukrainian / Українська](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ua.md)
+- [Urdu / اردو](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ur.md)
+- [Vietnamese / Tiếng Việt](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.vi.md)
+

doc/i18n/README.hu.md

@@ -0,0 +1,128 @@
+<h3 align="center"><img width="80" alt="Puter.com, A személyi felhő számítógép:  Minden fájl, alkalmazás és játék egy helyen elérhető bárhonnan, bármikor." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Az internetes oprendszer! Ingyenes, nyílt-forráskódú, saját szerveren futtatható.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« ÉLŐ DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+A Puter egy fejlett, nyílt forráskódú internetes operációs rendszer, amelyet úgy terveztek, hogy funkciókban gazdag, kivételesen gyors és nagymértékben bővíthető legyen. A Puter a következőképpen használható:
+
+- Egy adatvédelmet előtérbe helyező személyes felhő, amely minden fájlt, alkalmazást és játékot egy biztonságos helyen tart. Bárhonnan és bármikor elérhető.
+- Egy platform weboldalak, web-appok, és játékok készítéséhez/közzétételéhez.
+- A Dropbox, Google Drive, OneDrive (stb.) alternatívája megújult felülettel és hatékony funkciókkal.
+- Egy távoli desktop-környezet szervereknek és workstation-öknek.
+- Egy barátságos, nyílt forráskódú projekt és közösség, amely a webfejlesztéssel, a felhőalapú számítástechnikával, elosztott rendszerekkel és sok más érdekes témával foglalkozik!
+
+<br/>
+
+## Első lépések
+
+
+### 💻 Helyi (lokális) fejlesztés
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Ezzel a http://puter.localhost:4100 -on futtatjuk Putert. (vagy a legközelebbi elérhető porton).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+A Puter elérhető hostolt szolgáltatásként a [**puter.com**](https://puter.com) címen.
+
+<br/>
+
+## Rendszerkövetelmények
+
+- **Operációs rendszerek:** Linux, macOS, Windows
+- **RAM:** 2GB minimum (4GB ajánlott)
+- **Tárhely:** 1GB szabad tárhely
+- **Node.js:** 16+ (22+ verzió ajánlott)
+- **npm:** legújabb stabil verzió
+
+<br/>
+
+## Támogatás
+
+Lépj kapcsolatba a fejlesztőkkel és a közösséggel az alábbi platformokon:
+
+- Észrevételeid/javaslataid vannak? Az [alábbi linken](https://github.com/HeyPuter/puter/issues/new/choose) megoszthatod velünk.
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Biztonsági hibák? [[email protected]](mailto:[email protected])
+- A fejlesztőket a [[email protected]](mailto:[email protected]) email címen érheted el.
+
+
+Mindig örömmel segítünk bármilyen felmerülő kérdésben. Bátran kérdezz tőlünk!
+
+<br/>
+
+
+##  License
+
+
+Ez a repo, beleértve annak minden tartalmát, alprojektjeit, moduljait és komponenseit, az [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) licenc alatt áll, hacsak másképp nem rendelkeznek róla. A repoban szereplő harmadik fél által fejlesztett könyvtárak saját licencfeltételek alá eshetnek.
+
+<br/>

doc/i18n/README.hy.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Ինտերնետ ՕՀ! Անվճար, բաց կոդով և ինքնահոսթ հնարավորությամբ։</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« Օնլայն դեմո »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter-ը առաջադեմ, բաց կոդով ինտերնետային օպերացիոն համակարգ է, որը նախագծված է լինել ֆունկցիոնալ հարուստ, բացառիկ արագ և բարձր ընդլայնելի։ Puter-ը կարող է օգտագործվել հետևյալ կերպ․
+
+- Անձնական ամպային համակարգ՝ առաջնային գաղտնիությամբ, որը թույլ է տալիս պահել ձեր բոլոր ֆայլերը, հավելվածները և խաղերը մեկ անվտանգ վայրում, որը հասանելի է ցանկացած վայրից և ցանկացած ժամանակ։
+- Պլատֆորմ կայքերի, վեբ հավելվածների և խաղերի ստեղծման և հրապարակման համար։
+- Dropbox, Google Drive, OneDrive և այլ ծառայությունների այլընտրանք՝ նոր ինտերֆեյսով և հզոր գործառույթներով։
+- Հեռավոր աշխատասեղանի միջավայր սերվերների և աշխատանքային կայանների համար։
+- Պարզ, բաց կոդով նախագիծ և համայնք՝ վեբ ծրագրավորման, ամպային հաշվարկների, բաշխված համակարգերի և այլ թեմաների մասին սովորելու համար։
+
+<br/>
+
+## Սկսել
+
+
+### 💻 Լոկալ ծրագրավորում
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Սա կգործակի Puter-ը հետևյալ հասցեով՝ http://puter.localhost:4100 (կամ հաջորդ հասանելի պորտով)։
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter-ը հասանելի է որպես հյուրընկալվող ծառայություն [**puter.com**](https://puter.com).
+
+<br/>
+
+## System Requirements
+
+- **Օպերացիոն համակարգ:** Linux, macOS, Windows
+- **Օպերատիվ հիշողություն:** 2GB նվազագույնը (4GB խորհուրդ է տրվում)
+- **Համակարգչի հիշողություն:** 1GB ազատ տարածություն
+- **Node.js:** Տարբերակ 16+ (Տարբերակ 22+ խորհուրդ է տրվում)
+- **npm:** Վերջին կայուն տարբերակը
+
+<br/>
+
+## Աջակցություն
+
+Կապվեք համակարգողների և համայնքի հետ այս կայքերի միջոցով՝
+
+- Սխալների կամ գործառույթի հարցում՝ (https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Անվտանգության խնդիրներ՝ [[email protected]](mailto:[email protected])
+- Email maintainers at [[email protected]](mailto:[email protected])
+
+Մենք միշտ ուրախ ենք օգնել ձեզ ցանկացած հարցում։ Մի կաշկանդվեք հարցնել։
+
+<br/>
+
+
+##  Լիցենզիա
+
+Այս պահոցարանը, ներառյալ բոլոր իր բովանդակությունը, ենթա-պրոյեկտները, մոդուլները և բաղադրիչները, լիցենզավորվում են [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) լիցենզիայի տակ, եթե այլ կերպ հստակ նշված չէ։ Այս պահոցարանում ներառված երրորդ կողմի գրադարանները կարող են ենթարկվել իրենց սեփական լիցենզիաներին։
+
+<br/>

doc/i18n/README.id.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, Komputer Cloud Pribadi: Semua file, aplikasi, dan permainan Anda berada di satu tempat yang dapat diakses dari mana saja kapan saja." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Sistem Operasi Internet! Gratis, Sumber Terbuka, dan Dapat Dihosting Sendiri.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter adalah sistem operasi internet canggih, open-source, yang dirancang untuk menjadi kaya fitur, sangat cepat, dan sangat dapat diperluas. Puter dapat digunakan sebagai:
+
+- Cloud pribadi yang mengutamakan privasi untuk menyimpan semua file, aplikasi, dan permainan Anda di satu tempat yang aman, yang dapat diakses dari mana saja kapan saja.
+- Platform untuk membangun dan mempublikasikan situs web, aplikasi web, dan permainan.
+- Alternatif untuk Dropbox, Google Drive, OneDrive, dll. Dengan antarmuka baru dan fitur-fitur canggih.
+- Lingkungan desktop jarak jauh untuk server dan workstation.
+- Proyek dan komunitas open-source yang ramah untuk belajar tentang pengembangan web, komputasi gemawan (cloud), sistem terdistribusi, dan banyak lagi!
+
+<br/>
+
+## Memulai
+
+
+### 💻 Pengembangan Lokal
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Ini akan menjalankan Puter di http://puter.localhost:4100 (atau di port berikutnya yang tersedia)
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter tersedia sebagai layanan yang telah dihosting di [**puter.com**](https://puter.com).
+
+<br/>
+
+## Persyaratan Sistem
+
+- **Sistem Operasi:** Linux, macOS, Windows
+- **RAM:** 2GB minimal (rekomendasi 4GB)
+- **Penyimpanan:** 1GB ruang tersedia
+- **Node.js:** Version 16+ (rekomendasi versi 22+)
+- **npm:** Versi stabil termutakhir
+
+<br/>
+
+## Dukuangan
+
+Terhubung dengan maintainer dan komunitas melalui saluran-saluran berikut:
+
+- Laporan bug atau permintaan fitur? Silakan [buat issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Isu keamanan? [[email protected]](mailto:[email protected])
+- Email pengelola di [[email protected]](mailto:[email protected])
+
+Kami selalu senang membantu Anda dengan pertanyaan apa pun yang Anda miliki. Jangan ragu untuk bertanya!
+
+<br/>
+
+
+##  Lisensi
+
+Repositori ini, termasuk semua isinya, sub-proyek, modul, dan komponen, dilisensikan di bawah [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) kecuali dinyatakan sebaliknya secara eksplisit. Perpustakaan pihak ketiga yang termasuk dalam repositori ini mungkin tunduk pada lisensinya sendiri.
+
+<br/>

doc/i18n/README.it.md

@@ -0,0 +1,128 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Il sistema operativo di Internet! Gratuito, Open-Source e Auto-Hostabile.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter è un sistema operativo di Internet avanzato e open-source, progettato per essere ricco di funzionalità, eccezionalmente veloce e altamente estensibile. Puter può essere utilizzato come:
+
+- Un cloud personale che tiene conto della privacy per conservare tutti i file, le app e i giochi in un luogo sicuro, accessibile da qualsiasi luogo e in qualsiasi momento.
+- Una piattaforma per creare e pubblicare siti web, app e giochi.
+- Un'alternativa a Dropbox, Google Drive, OneDrive, ecc. con un'interfaccia nuova e funzioni potenti. 
+- Un ambiente desktop remoto per server e workstation. 
+- Un progetto e una comunità open-source amichevole per imparare lo sviluppo web, il cloud computing, i sistemi distribuiti e molto altro ancora!
+
+<br/>
+
+## Getting Started
+
+
+### 💻 Local Development
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+In questo modo Puter verrà avviato all'indirizzo http://puter.localhost:4100 (o alla prossima porta disponibile).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter è disponibile come servizio in hosting su [**puter.com**](https://puter.com).
+
+<br/>
+
+## Requisiti di Sistema
+
+- **Sistema Operativo:** Linux, macOS, Windows
+- **RAM:** 2GB minimi (4GB raccomandati)
+- **Spazio su Disco:** 1GB liberi
+- **Node.js:** Versione 16+ (Versione 22+ raccomandati)
+- **npm:** Ultima versione stabile
+
+<br/>
+
+## Supporto
+
+Collegatevi con i maintainers e la comunità attraverso questi canali:
+
+- Segnalazione di bug o richiesta di funzionalità? Perfavore [aprire una issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Problemi di sicurezza? [[email protected]](mailto:[email protected])
+- Email maintainers a [[email protected]](mailto:[email protected])
+
+Siamo sempre felici di aiutarvi con qualsiasi domanda. Non esitate a chiedere!
+
+<br/>
+
+
+##  Licenza
+
+Questo repository, compresi tutti i suoi contenuti, sottoprogetti, moduli e componenti, è concesso in licenza [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt), a meno che non sia esplicitamente indicato diversamente. Le librerie di terze parti incluse in questo repository possono essere soggette alle loro licenze.
+
+<br/>
+

doc/i18n/README.jp.md

@@ -0,0 +1,123 @@
+
+<h3 align="center"><img width="80" alt="Puter.com, あなたのファイル、アプリ、ゲームをどこからでもアクセス可能にするパーソナルクラウドコンピュータ" src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">インターネットOS！無料、オープンソース、セルフホスト可能。</h3>
+
+<p align="center">
+    <img alt="GitHub リポジトリサイズ" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub リリース" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=%E6%9C%80%E6%96%B0%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3"> <img alt="GitHub ライセンス" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« ライブデモ »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="スクリーンショット" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puterは、機能豊富で非常に高速、そして高い拡張性を持つ、先進的なオープンソースのインターネットオペレーティングシステムです。Puterは以下の用途に利用できます：
+
+- プライバシーを最優先するパーソナルクラウドとして、あなたのファイル、アプリ、ゲームを一か所で安全に管理し、どこからでもアクセス可能に。
+- ウェブサイト、ウェブアプリ、ゲームの作成と公開のためのプラットフォーム。
+- Dropbox、Google Drive、OneDriveなどの代替として、新しいインターフェースと強力な機能を提供。
+- サーバーやワークステーションのためのリモートデスクトップ環境。
+- ウェブ開発、クラウドコンピューティング、分散システムなどを学ぶための、フレンドリーでオープンなコミュニティとプロジェクト。
+
+<br/>
+
+## はじめに
+
+
+### 💻 ローカル開発
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+これでPuterが http://puter.localhost:4100 （または次に利用可能なポート）で起動します。
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puterは[**puter.com**](https://puter.com)でホストサービスとして利用可能です。
+
+<br/>
+
+## システム要件
+
+- **オペレーティングシステム:** Linux, macOS, Windows
+- **RAM:** 最小2GB（推奨4GB）
+- **ディスクスペース:** 1GBの空き容量
+- **Node.js:** バージョン16以上（推奨バージョン22以上）
+- **npm:** 最新の安定バージョン
+
+<br/>
+
+## サポート
+
+メンテナーやコミュニティと以下のチャンネルを通じてつながりましょう：
+
+- バグ報告や機能リクエストがありますか？ [issueを開く](https://github.com/HeyPuter/puter/issues/new/choose) してください。
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- セキュリティの問題？ [[email protected]](mailto:[email protected])
+- メンテナーへのメールは [[email protected]](mailto:[email protected]) まで
+
+質問があれば、いつでもお気軽にお問い合わせください！
+
+<br/>
+
+## ライセンス
+
+このリポジトリ、ならびにそのすべてのコンテンツ、サブプロジェクト、モジュール、コンポーネントは、[AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt)の下でライセンスされています。明示的に異なるライセンスが示されている場合を除きます。このリポジトリに含まれるサードパーティのライブラリは、それぞれのライセンスが適用される場合があります。
+
+<br/>

doc/i18n/README.ko.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Puter: 인터넷 OS! 무료이고 오픈소스이며 자체 호스팅이 가능합니다.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« 시연 영상 »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter는 오픈소스 인터넷 운영 체제로, 매우 빠르고 확장성이 뛰어나며 새로운 인터페이스와 다양한 기능을 갖추고 있습니다. Puter는 다음과 같이 사용될 수 있습니다:
+
+- 모든 파일, 앱, 게임을 한 곳에 안전하게 보관하고 언제 어디서나 접근할 수 있는 프라이버시 중심의 개인 클라우드로 사용할 수 있습니다.
+- 웹사이트, 웹 앱, 게임을 구축하고 배포하는 플랫폼으로 활용할 수 있습니다.
+- Dropbox, Google Drive, OneDrive 등의 대안으로 사용할 수 있으며 보다 발전된 기능과 인터페이스를 제공합니다.
+- 서버와 워크스테이션을 위한 원격 데스크톱 환경으로 활용할 수 있습니다.
+- 웹 개발, 클라우드 컴퓨팅, 분산 시스템 등에 대해 배울 수 있는 친근한 오픈소스 프로젝트이자 커뮤니티입니다!
+
+<br/>
+
+## 시작하기
+
+
+### 💻 로컬 환경 개발
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+위처럼 실행할 시 Puter는 http://puter.localhost:4100 (또는 사용 가능한 다음 포트)에서 실행됩니다.
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter는 [**puter.com**](https://puter.com)에서 호스팅 서비스로 이용할 수 있습니다.
+
+<br/>
+
+## 시스템 요구사항
+
+- **Operating Systems:** Linux, macOS, Windows
+- **RAM:** 2GB minimum (4GB recommended)
+- **Disk Space:** 1GB free space
+- **Node.js:** Version 16+ (Version 22+ recommended)
+- **npm:** Latest stable version
+
+<br/>
+
+## 지원
+
+다음 채널을 통해 관리자 및 커뮤니티와 소통하세요:
+
+- 버그 신고나 기능 요청이 있으신가요? [이슈를 열어주세요.](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- 보안 관련 문제는 [[email protected]](mailto:[email protected]) 으로 연락주세요.
+- 관리자에게 이메일 보내기: [[email protected]](mailto:[email protected])
+
+어떤 질문이든 기꺼이 도와드리겠습니다. 언제든 물어보세요!
+
+<br/>
+
+
+## 라이선스
+
+이 저장소는 모든 내용, 하위 프로젝트, 모듈 및 구성 요소를 포함하여 명시적으로 달리 명시되지 않는 한 [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) 라이선스 하에 제공됩니다. 이 저장소에 포함된 제3자 라이브러리는 해당 라이브러리의 고유 라이선스를 따를 수 있습니다.
+
+<br/>

doc/i18n/README.ml.md

@@ -0,0 +1,128 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">ഇന്റർനെറ്റ് ഓപ്പറേറ്റിംഗ് സിസ്റ്റം!<br> സൗജന്യവും, ഓപ്പൺ സോഴ്സും സ്വയം ഹോസ്റ്റ് ചെയ്യാൻ പറ്റുന്നതും</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« ലൈവ് ഡെമോ »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## പ്യൂട്ടർ (Puter)
+
+ഫീച്ചറുകളാൽ സമ്പുഷ്ടവും അസാധാരണമാംവിധം വേഗതയേറിയതും,വളരെ വിപുലീകരിക്കാവുന്നതുമായ ഒരു നൂതന, ഓപ്പൺ സോഴ്‌സ് ഇന്റർനെറ്റ് ഓപ്പറേറ്റിംഗ് സിസ്റ്റമാണ് പ്യൂട്ടർ. പ്യൂട്ടർ ഇനിപ്പറയുന്ന രീതിയിൽ ഉപയോഗിക്കാം:
+
+- നിങ്ങളുടെ എല്ലാ ഫയലുകളും ആപ്പുകളും ഗെയിമുകളും ഒരു സുരക്ഷിത സ്ഥലത്ത് സൂക്ഷിക്കുന്നതിനുള്ള, സ്വകാര്യതയ്ക്ക് മുൻഗണന കൊടുക്കുന്ന ആദ്യത്തെ വ്യക്തിഗത ക്ലൗഡ്, എവിടെ നിന്നും എപ്പോൾ വേണമെങ്കിലും ആക്‌സസ് ചെയ്യാൻ കഴിയും.
+- വെബ്‌സൈറ്റുകൾ, വെബ് ആപ്പുകൾ, ഗെയിമുകൾ എന്നിവ നിർമ്മിക്കുന്നതിനും പ്രസിദ്ധീകരിക്കുന്നതിനുമുള്ള ഒരു പ്ലാറ്റ്ഫോം.
+- പുതിയ ഇന്റർഫേസും, ശക്തമായ ഫീച്ചറുകളും അടങ്ങിയ, ഡ്രോപ്പ്‌ബോക്‌സ്, ഗൂഗിൾ ഡ്രൈവ്, വൺഡ്രൈവ് മുതലായവയ്‌ക്കുള്ള ബദൽ.
+- സെർവറുകൾക്കും വർക്ക്സ്റ്റേഷനുകൾക്കും, ഒരു വിദൂര ഡെസ്ക്ടോപ്പ് പരിസ്ഥിതി.
+- വെബ് ഡെവലപ്മെന്റ്, ക്ലൗഡ് കംപ്യൂട്ടിംഗ്, ഡിസ്ട്രിബ്യൂട്ടഡ് സിസ്റ്റങ്ങൾ എന്നിവയെ കുറിച്ചും, അതിലേറെ കാര്യങ്ങളെ കുറിച്ചും അറിയാനുള്ള സൗഹൃദപരവും ഓപ്പൺ സോഴ്സുമായ പ്രോജക്റ്റും കമ്മ്യൂണിറ്റിയും!
+
+<br/>
+
+## തുടങ്ങാനായി
+
+
+### 💻 ലോക്കൽ ഡെവലപ്മെന്റ്
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+
+ഇത് http://puter.localhost:4100 (അല്ലെങ്കിൽ അടുത്ത ലഭ്യമായ പോർട്ടിൽ) എന്നതിൽ Puter സമാരംഭിക്കും
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+പ്യൂട്ടർ [**puter.com**](https://puter.com) എന്നതിൽ ഹോസ്റ്റ് ചെയ്‌ത സേവനമായി ലഭ്യമാണ്.
+
+<br/>
+
+## സിസ്റ്റത്തിന്റെ ആവശ്യകതകൾ
+
+- **ഓപ്പറേറ്റിംഗ് സിസ്റ്റങ്ങൾ:** ലിനക്സ്, മാക്ക് ഒഎസ്, വിൻഡോസ്
+- **RAM:** 2GB കുറഞ്ഞത് (4GB ശുപാർശ ചെയ്യുന്നു)
+- **ഡിസ്ക് സ്പേസ്:** 1GB ഒഴിഞ്ഞ ഇടം
+- **Node.js:** Version 16+ (Version 22+ ശുപാർശ ചെയ്യുന്നു)
+- **npm:** ഏറ്റവും പുതിയ സ്ഥിരതയുള്ള പതിപ്പ്
+
+<br/>
+
+## പിന്തുണ
+
+ഈ ചാനലുകളിലൂടെ പരിപാലിക്കുന്നവരുമായും കമ്മ്യൂണിറ്റിയുമായും ബന്ധപ്പെടുക:
+
+- ബഗ്ഗ് റിപ്പോർട്ടോ, ഫീച്ചർ റിക്ക്വസ്റ്റോ ഉണ്ടോ? ദയവുചെയ്ത് [ഒരു ഇഷ്യൂ തുടങ്ങുക](https://github.com/HeyPuter/puter/issues/new/choose).
+- ഡിസ്കോർഡ്: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- എക്സ് (ട്വിറ്റർ): [x.com/HeyPuter](https://x.com/HeyPuter)
+- റെഡ്ഡിറ്റ്: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- മാസ്റ്റഡൺ: [mastodon.social/@puter](https://mastodon.social/@puter)
+- സുരക്ഷാ പ്രശ്നങ്ങളുണ്ടോ? [[email protected]](mailto:[email protected])
+- ഇമെയിൽ മെയിന്റൈനർമാർ: [[email protected]](mailto:[email protected])
+
+നിങ്ങൾക്ക് ഉണ്ടായേക്കാവുന്ന ഏത് ചോദ്യങ്ങളിലും നിങ്ങളെ സഹായിക്കുന്നതിൽ ഞങ്ങൾക്ക് എപ്പോഴും സന്തോഷമുണ്ട്. ചോദിക്കാൻ മടിക്കേണ്ട!
+
+<br/>
+
+
+##  ലൈസൻസ്
+
+ഈ ശേഖരം, അതിന്റെ എല്ലാ ഉള്ളടക്കങ്ങളും, ഉപപദ്ധതികളും, മൊഡ്യൂളുകളും, ഘടകങ്ങളും ഉൾപ്പെടെ, [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) എന്നതിന് കീഴിൽ ലൈസൻസുള്ളതാണ്. ഈ ശേഖരത്തിൽ ഉൾപ്പെടുത്തിയിരിക്കുന്ന മൂന്നാം കക്ഷി ലൈബ്രറികൾ അവരുടെ സ്വന്തം ലൈസൻസുകൾക്ക് വിധേയമായിരിക്കാം.
+
+<br/>

doc/i18n/README.my.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: Semua fail, apl, dan permainan anda di satu tempat yang boleh diakses dari mana sahaja pada bila-bila masa." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Sistem Operasi Internet! Percuma, Sumber Terbuka, dan Boleh Dihoskan Sendiri.</h3>
+
+<p align="center">
+    <img alt="Saiz repo GitHub" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="Terbitan GitHub" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="Lesen GitHub" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« DEMO SECARA LANGSUNG »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter ialah sistem operasi internet sumber terbuka yang maju dan direka untuk kaya dengan ciri kefungsian, kepantasan luar biasa dan kebolehluasan yang tinggi. Puter boleh digunakan sebagai:
+
+- Storan awan peribadi yang mendahulukan privasi untuk menyimpan semua fail, aplikasi dan permainan anda di satu tempat yang selamat dan boleh diakses dari mana sahaja pada bila-bila masa.
+- Platform untuk membina dan menerbitkan laman web, aplikasi web dan permainan.
+- Alternatif kepada Dropbox, Google Drive, OneDrive, dan lain-lain dengan antara muka yang baharu dan ciri kefungsian berkuasa tinggi.
+- Persekitaran desktop awan untuk server dan stesen kerja.
+- Projek dan komuniti sumber terbuka yang mesra untuk mempelajari pembangunan laman web, pengkomputeran awan, sistem teragih, dan banyak lagi!
+
+<br/>
+
+## Mulakan
+
+
+### 💻 Pembangunan Lokal
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Ini akan melancarkan Puter di http://puter.localhost:4100 (atau port seterusnya yang tersedia).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter tersedia sebagai perkhidmatan terhos di [**puter.com**](https://puter.com).
+
+<br/>
+
+## Keperluan Sistem
+
+- **Sistem Operasi:** Linux, macOS, Windows
+- **RAM:** Minimum 2GB (sebaiknya 4GB)
+- **Ruang Storan:** 1GB ruang kosong
+- **Node.js:** Versi 16+ (sebaiknya Versi 22+)
+- **npm:** Versi stabil yang terkini
+
+<br/>
+
+## Sokongan
+
+Berhubung dengan penyelenggara dan komuniti melalui saluran berikut:
+
+- Laporan pepijat atau permintaan ciri? Sila [buka isu baharu](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Isu keselamatan? [[email protected]](mailto:[email protected])
+- Emel penyelenggara melalui [[email protected]](mailto:[email protected])
+
+Kami sentiasa gembira untuk membantu anda dengan apa-apa soalan. Jangan takut untuk bertanya!
+
+<br/>
+
+
+## Lesen
+
+Repositori ini, termasuklah kandungannya, subprojek, modul dan komponen, dilesenkan di bawah [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) melainkan dinyatakan sebaliknya. *Library* pihak ketiga yang terkandung dalam repositori ini tertakluk kepada lesen mereka sendiri.
+<!-- The word `Library` is kept as is to avoid confusion since the direct translation `Perpustakaan/Pustaka` is never used in the tech context and doesn't convey the same meaning among Malay community if used in this situation -->
+<br/>

doc/i18n/README.nl.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, De Persoonlijke Cloud Computer: Al je bestanden, apps en games op één plek, overal en altijd toegankelijk." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Het Internet OS! Gratis, Open-Source en Zelf te Hosten.</h3>
+
+<p align="center">
+    <img alt="GitHub repo grootte" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=laatste%20versie"> <img alt="GitHub Licentie" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter is een geavanceerd, open-source internetbesturingssysteem ontworpen om functierijk, uitzonderlijk snel en zeer uitbreidbaar te zijn. Puter kan worden gebruikt als:
+
+- Een privacy-gerichte persoonlijke cloud om al je bestanden, apps en games op één veilige plek te bewaren, overal en altijd toegankelijk.
+- Een platform voor het bouwen en publiceren van websites, web-apps en games.
+- Een alternatief voor Dropbox, Google Drive, OneDrive, etc. met een frisse interface en krachtige functies.
+- Een externe desktopomgeving voor servers en werkstations.
+- Een vriendelijk, open-source project en gemeenschap om te leren over webontwikkeling, cloud computing, gedistribueerde systemen en veel meer!
+
+<br/>
+
+## Aan de slag
+
+
+### 💻 Lokale Ontwikkeling
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Dit zal Puter starten op http://puter.localhost:4100 (of de eerstvolgende beschikbare poort).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter is beschikbaar als een gehoste service op [**puter.com**](https://puter.com).
+
+<br/>
+
+## Systeemvereisten
+
+- **Besturingssystemen:** Linux, macOS, Windows
+- **RAM:** 2GB minimum (4GB aanbevolen)
+- **Schijfruimte:** 1GB vrije ruimte
+- **Node.js:** Versie 16+ (Versie 22+ aanbevolen)
+- **npm:** Laatste stabiele versie
+
+<br/>
+
+## Ondersteuning
+
+Verbind met de onderhouders en de gemeenschap via deze kanalen:
+
+- Bug rapport of functieverzoek? [Open een issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Beveiligingsproblemen? [[email protected]](mailto:[email protected])
+- E-mail onderhouders op [[email protected]](mailto:[email protected])
+
+We helpen je graag met al je vragen. Aarzel niet om te vragen!
+
+<br/>
+
+
+## Licentie
+
+Deze repository, inclusief alle inhoud, subprojecten, modules en componenten, is gelicentieerd onder [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) tenzij expliciet anders vermeld. Bibliotheken van derden die in deze repository zijn opgenomen, kunnen onderworpen zijn aan hun eigen licenties.
+
+<br/>

doc/i18n/README.od.md

@@ -0,0 +1,148 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">ଇଣ୍ଟରନେଟ OS! ନିଶୁଳ୍କ, ଖୋଲା-ମୂଳ (Open-Source), ଏବଂ ସ୍ୱୟଂ-ହୋଷ୍ଟ କରିପାରିବା।</h3>
+
+<p align="center">
+    <a href="https://puter.com/?ref=github.com"><strong>« LIVE ଡେମୋ »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com/?ref=github.com">Puter.com</a>
+    ·
+    <a href="https://apps.puter.com/">App Store</a>
+    ·
+    <a href="https://developer.puter.com" target="_blank">Developers</a>
+    ·
+    <a href="https://github.com/heyputer/puter-cli" target="_blank">CLI</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter ହେଉଛି ଗୋଟିଏ ଉନ୍ନତ, ଖୋଲା-ମୂଳ ଇଣ୍ଟରନେଟ ଅପରେଟିଂ ସିଷ୍ଟମ, ଯାହାକି ବିଶେଷତାସମୃଦ୍ଧ, ଶୀଘ୍ର ଏବଂ ଏକ୍ସଟେନ୍ସିବଲ ଭାବେ ଡିଜାଇନ୍ କରାଯାଇଛି। Puter କୁ ନିମ୍ନ ପ୍ରକାରେ ବ୍ୟବହାର କରିପାରିବେ:
+
+- ଗୋଟିଏ ପ୍ରାଇଭେସି-ପ୍ରଥମ (privacy-first) ପର୍ସନାଲ କ୍ଲାଉଡ୍ ଭାବେ — ଯେଉଁଠାରେ ଆପଣଙ୍କ ସମସ୍ତ ଫାଇଲ୍, ଆପ୍ସ ଏବଂ ଗେମ୍ସ ଗୋଟିଏ ସୁରକ୍ଷିତ ସ୍ଥାନରେ ରହିବ, ଯାହାକୁ କେଉଁଠୁ ସମୟରେ ଆକ୍ସେସ୍ କରିପାରିବେ।
+- ୱେବସାଇଟ୍, ୱେବ ଆପ୍ସ, ଏବଂ ଗେମ୍ ତିଆରି ଏବଂ ପ୍ରକାଶ ପାଇଁ ଗୋଟିଏ ପ୍ଲାଟଫର୍ମ।
+- Dropbox, Google Drive, OneDrive ଇତ୍ୟାଦିଙ୍କ ବିକଳ୍ପ ଭାବେ — ଏକ ସୁନ୍ଦର ଇଣ୍ଟରଫେସ୍ ଏବଂ ଶକ୍ତିଶାଳୀ ବୈଶିଷ୍ଟ ସହିତ।
+- ସର୍ଭର ଏବଂ ଓର୍କସ୍ଟେସନ୍ ପାଇଁ ଗୋଟିଏ ରିମୋଟ୍ ଡେସ୍କଟପ୍ ଇନ୍ଭାୟରମେଣ୍ଟ।
+- ୱେବ୍ ଡିଭେଲପମେଣ୍ଟ, କ୍ଲାଉଡ୍ କମ୍ପ୍ୟୁଟିଙ୍ଗ, ବିତରିତ ସିଷ୍ଟମ (distributed systems) ଇତ୍ୟାଦି ଶିଖିବା ପାଇଁ ଗୋଟିଏ ସହଜ-ମନୋଭାବୀ ଖୋଲା-ମୂଳ ସମୁଦାୟ।
+
+<br/>
+
+## ପ୍ରାରମ୍ଭ (Getting Started)
+
+### 💻 Local Development
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+**→** ଏହା Puter କୁ ଲଞ୍ଚ କରିବ:  
+<font color="red"> http://puter.localhost:4100 (ଅଥବା ଅନ୍ୟ ଉପଲବ୍ଧ ପୋର୍ଟ୍) </font>
+
+ଯଦି ଏହା କାମ କରୁନାହିଁ, ତେବେ [First Run Issues](./doc/self-hosters/first-run-issues.md) କୁ ଦେଖନ୍ତୁ।
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+**→** ଏହା Puter କୁ ଲଞ୍ଚ କରିବ:  
+<font color="red"> http://puter.localhost:4100 (ଅଥବା ଅନ୍ୟ ଉପଲବ୍ଧ ପୋର୍ଟ୍) </font>
+
+<br/>
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+**→** ଏହା ଉପଲବ୍ଧ ହେବ:  
+<font color="red"> http://puter.localhost:4100 (ଅଥବା ଅନ୍ୟ ଉପଲବ୍ଧ ପୋର୍ଟ୍) </font>
+
+<br/>
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+**→** ଏହା Puter କୁ ଲଞ୍ଚ କରିବ:  
+<font color="red"> http://puter.localhost:4100 (ଅଥବା ଅନ୍ୟ ଉପଲବ୍ଧ ପୋର୍ଟ୍) </font>
+
+<br/>
+
+### 🚀 Self-Hosting
+
+Self-Hosting ପାଇଁ ବିସ୍ତୃତ ଗାଇଡ୍, କନଫିଗୁରେସନ୍ ଅପ୍ସନ୍ ଏବଂ ବେଷ୍ଟ-ପ୍ରାକ୍ଟିସ୍ ପାଇଁ ଏଠାରେ ଯାଆନ୍ତୁ:  
+[Self-Hosting Documentation](https://github.com/HeyPuter/puter/blob/main/doc/self-hosters/instructions.md)
+
+<br/>
+
+### ☁️ Puter.com
+
+Puter ହୋଷ୍ଟେଡ୍ ସର୍ଭିସ୍ ଭାବେ ଉପଲବ୍ଧ ଅଛି: [**puter.com**](https://puter.com)
+
+<br/>
+
+## ସିଷ୍ଟମ ଆବଶ୍ୟକତା (System Requirements)
+
+- **Operating Systems:** Linux, macOS, Windows  
+- **RAM:** ଅନ୍ୟୁନ 2GB (ପରାମର୍ଶ 4GB)  
+- **Disk Space:** 1GB ଖାଲି ସ୍ଥାନ  
+- **Node.js:** ସଂସ୍କରଣ 20.19.5+ (ପରାମର୍ଶ 23+)  
+- **npm:** ନବୀନତମ ସ୍ଥିର ସଂସ୍କରଣ  
+
+<br/>
+
+## ସହଯୋଗ (Support)
+
+ମେଣ୍ଟେନର୍ ଏବଂ ସମୁଦାୟ ସହିତ ଯୋଡ଼ିବା ପାଇଁ:
+
+- Bug report କିମ୍ବା ନୂଆ feature ବାବଦରେ? [open an issue](https://github.com/HeyPuter/puter/issues/new/choose)
+- Discord: https://discord.com/invite/PQcx7Teh8u
+- X (Twitter): https://x.com/HeyPuter
+- Reddit: https://www.reddit.com/r/puter/
+- Mastodon: https://mastodon.social/@puter
+- Security issues? [[email protected]](mailto:[email protected])
+- Maintain­er Email: [[email protected]](mailto:[email protected])
+
+ଆମେ ସମସ୍ତେ ସହାୟତା ପାଇଁ ସଦା ପ୍ରସ୍ତୁତ।
+
+<br/>
+
+## ଲାଇସେନ୍ସ (License)
+
+ଏହି ରିପୋଜିଟୋରୀ, ସମସ୍ତ ସବ୍-ପ୍ରୋଜେକ୍ଟ, ମୋଡ୍ୟୁଲ୍ ଏବଂ କମ୍ପୋନେଣ୍ଟ ସହିତ **AGPL-3.0** ଲାଇସେନ୍ସ ଅଧୀନରେ ରହିଛି।  
+ତୃତୀୟ ପକ୍ଷ ଲାଇବ୍ରେରି ନିଜସ୍ୱ ଲାଇସେନ୍ସ ଅଧୀନରେ ଥାଇପାରେ।
+
+<br/>
+
+## ଅନ୍ୟ README ଲିଙ୍କ୍ (Links to Other READMEs)
+
+### Backend
+- [PuterAI Module](./src/backend/doc/modules/puterai/README.md)
+- [Metering Service](./src/backend/src/services/MeteringService/README.md)
+- [Extensions Development Guide](./extensions/README.md)

doc/i18n/README.pa.md

@@ -0,0 +1,182 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">ਇੰਟਰਨੇਟ ਓਐਸ! ਮੁਫ਼ਤ, ਖੁੱਲ੍ਹੇ ਸਰੋਤ ਵਾਲਾ, ਅਤੇ ਆਪ ਸਵੈ-ਹੋਸਟ ਕਰ ਸਕਦੇ ਹੋ।</h3>
+
+<p align="center">
+    <a href="https://puter.com/?ref=github.com"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com/?ref=github.com">Puter.com</a>
+    ·
+    <a href="https://apps.puter.com/">ਐਪ ਸਟੋਰ</a>
+    ·
+    <a href="https://developer.puter.com" target="_blank">ਡਿਵੈਲਪਰ</a>
+    ·
+    <a href="https://github.com/heyputer/puter-cli" target="_blank">CLI</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter ਇੱਕ ਵਿਕਸਤ, ਖੁੱਲ੍ਹਾ-ਸਰੋਤ ਇੰਟਰਨੇਟ ਓਪਰੇਟਿੰਗ ਸਿਸਟਮ ਹੈ ਜੋ ਫੀਚਰ-ਭਰਪੂਰ, ਬਹੁਤ ਤੇਜ਼, ਅਤੇ ਵਧੀਆ ਤਰੀਕੇ ਨਾਲ ਵਧਾਏ ਜਾਣ ਵਾਲਾ ਬਣਾਇਆ ਗਿਆ ਹੈ। Puter ਇਸ ਤਰ੍ਹਾਂ ਵਰਤਿਆ ਜਾ ਸਕਦਾ ਹੈ:
+
+- ਇੱਕ ਪਰਾਈਵੇਸੀ-ਪਹਿਲਾਂ ਨਿੱਜੀ ਕਲਾਊਡ ਵਜੋਂ ਜਿੱਥੇ ਤੁਹਾਡੀਆਂ ਸਾਰੀਆਂ ਫਾਈਲਾਂ, ਐਪਸ, ਅਤੇ ਗੇਮਜ਼ ਇੱਕ ਸੁਰੱਖਿਅਤ ਜਗ੍ਹਾ 'ਤੇ, ਕਿਸੇ ਵੀ ਸਮੇਂ-ਕਿਤੇ ਵੀ ਤੋਂ ਪਹੁੰਚਯੋਗ।
+- ਵੈਬਸਾਈਟਾਂ, ਵੈਬ ਐਪਸ, ਅਤੇ ਗੇਮ ਬਣਾਉਣ ਅਤੇ ਪ੍ਰਕਾਸ਼ਿਤ ਕਰਨ ਲਈ ਇੱਕ ਪਲੇਟਫਾਰਮ।
+- Dropbox, Google Drive, OneDrive ਆਦਿ ਦਾ ਇੱਕ ਆਧੁਨਿਕ ਵਿਕਲਪ, ਨਵੀਂ ਇੰਟਰਫੇਸ ਅਤੇ ਸ਼ਕਤੀਸ਼ਾਲੀ ਫੀਚਰਾਂ ਨਾਲ।
+- ਸਰਵਰਾਂ ਅਤੇ ਵਰਕਸਟੇਸ਼ਨਾਂ ਲਈ ਰਿਮੋਟ ਡੈਸਕਟਾਪ Environment।
+- ਵੈਬ ਡਿਵੈਲਪਮੈਂਟ, ਕਲਾਊਡ ਕੰਪਿਊਟਿੰਗ, ਡਿਸਟ੍ਰੀਬਿਊਟਡ ਸਿਸਟਮ ਅਤੇ ਹੋਰ ਬਹੁਤ ਕੁਝ ਸਿੱਖਣ ਲਈ ਇੱਕ ਮਿੱਤਰਤਾਪੂ, ਖੁੱਲ੍ਹੇ-ਸਰੋਤ ਵਾਲਾ ਪ੍ਰੋਜੈਕਟ ਅਤੇ ਸਮੂਹ!
+
+<br/>
+
+## Getting Started
+
+### 💻 Local Development
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+**→** ਇਹ Puter ਨੂੰ ਇਸ ਪਤੇ 'ਤੇ ਚਲਾਉਣਾ ਚਾਹੀਦਾ ਹੈ 
+<font color="red"> http://puter.localhost:4100 (ਜਾਂ ਅਗਲਾ ਉਪਲਬਧ ਪੋਰਟ). </font>
+
+ਜੇ ਇਹ ਕੰਮ ਨਹੀਂ ਕਰਦਾ, ਤਾੰ [First Run Issues](./doc/self-hosters/first-run-issues.md) ਵੇਖੋ
+ਟ੍ਰਬਲਸ਼ੂਟਿੰਗ ਲਈ।
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+**→** ਇਹ Puter ਨੂੰ ਇਸ ਪਤੇ 'ਤੇ ਚਲਾਉਣਾ ਚਾਹੀਦਾ ਹੈ 
+<font color="red"> http://puter.localhost:4100 (ਜਾਂ ਅਗਲਾ ਉਪਲਬਧ ਪੋਰਟ). </font>
+
+<br/>
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+**→** ਇਹ ਇਸ ਪਤੇ 'ਤੇ ਉਪਲਬਧ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ 
+<font color="red"> http://puter.localhost:4100 (ਜਾਂ ਅਗਲਾ ਉਪਲਬਧ ਪੋਰਟ). </font>
+
+<br/>
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+**→** ਇਹ Puter ਨੂੰ ਇਸ ਪਤੇ 'ਤੇ ਚਲਾਉਣਾ ਚਾਹੀਦਾ ਹੈ 
+<font color="red"> http://puter.localhost:4100 (ਜਾਂ ਅਗਲਾ ਉਪਲਬਧ ਪੋਰਟ). </font>
+
+<br/>
+
+### 🚀 Self-Hosting
+
+Puter ਨੂੰ ਖੁਦ ਹੋਸਟ ਕਰਨ ਲਈ, ਕਨਫਿਗੁਰੇਸ਼ਨ ਵਿਕਲਪ ਅਤੇ ਬਿਹਤਰੀਨ ਕਾਇਦੇ, ਸਾਰੇ ਵਿਸਥਾਰ ਲਈ ਸਾਡੇ [Self-Hosting Documentation](https://github.com/HeyPuter/puter/blob/main/doc/self-hosters/instructions.md) ਵੇਖੋ।
+
+<br/>
+
+### ☁️ Puter.com
+
+Puter [**puter.com**](https://puter.com) 'ਤੇ ਇੱਕ ਹੋਸਟ ਕੀਤੀ ਸੇਵਾ ਵਜੋਂ ਉਪਲਬਧ ਹੈ।
+
+<br/>
+
+## System Requirements
+
+- **Operating Systems:** Linux, macOS, Windows
+- **RAM:** ਘੱਟੋ-ਘੱਟ 2GB (4GB ਸਿਫ਼ਾਰਸ਼ੀ)
+- **Disk Space:** 1GB ਖਾਲੀ ਜਗ੍ਹਾ
+- **Node.js:** Version 24+
+- **npm:** ਨਵੀਨਤਮ ਸਥਿਰ ਵਰਜਨ
+
+<br/>
+
+## Support
+
+ਮੈਂਟੇਨਰਾਂ ਅਤੇ ਕਮਿਊਨਿਟੀ ਨਾਲ ਇੱਥੇ ਸੰਪਰਕ ਕਰੋ:
+
+- ਬੱਗ ਜਾਂ ਫੀਚਰ ਰਿਕਵੇਸਟ? ਕਿਰਪਾ ਕਰਕੇ [issue ਖੋਲ੍ਹੋ](https://github.com/HeyPuter/puter/issues/new/choose)।
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- ਸੁਰੱਖਿਆ ਮਸਲੇ? [[email protected]](mailto:[email protected])
+- ਮੇਂਟੇਨਰਾਂ ਨੂੰ ਈਮੇਲ ਕਰੋ [[email protected]](mailto:[email protected])
+
+ਅਸੀਂ ਹਮੇਸ਼ਾ ਤੁਹਾਡੀਆਂ ਕਿਸੇ ਵੀ ਪ੍ਰਸ਼ਨਾਂ ਵਿੱਚ ਮਦਦ ਕਰਨ ਲਈ ਤਿਆਰ ਹਾਂ। ਬੇਝਿਝਕ ਪੁੱਛੋ!
+
+<br/>
+
+## License
+
+ਇਹ ਰਿਪੋਜ਼ਟਰੀ, ਆਪਣੇ ਸਾਰੇ ਸਮੱਗਰੀ, ਸਬ-ਪ੍ਰੋਜੈਕਟ, ਮੋਡੀਊਲ, ਅਤੇ ਕੰਪੋਨੈਂਟ ਸਮੇਤ, [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) ਅਧੀਨ ਲਾਇਸੈਂਸਡ ਹੈ ਜੇ ਤਕ ਹੋਰ ਸਪਸ਼ਟ ਤੌਰ 'ਤੇ ਨਹੀਂ ਕਿਹਾ ਗਿਆ। ਤੀਜੀ ਪੱਖ ਦੀਆਂ ਲਾਇਬ੍ਰੇਰੀਆਂ ਆਪਣੇ ਲਾਇਸੈਂਸਾਂ ਅਨੁਸਾਰ ਹੋ ਸਕਦੀਆਂ ਹਨ।
+
+<br/>
+
+## Translations
+
+- [Arabic / العربية](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md)
+- [Armenian / Հայերեն](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hy.md)
+- [Bengali / বাংলা](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.bn.md)
+- [Chinese / 中文](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md)
+- [Danish / Dansk](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.da.md)
+- [English](https://github.com/HeyPuter/puter/blob/main/README.md)
+- [Farsi / فارسی](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fa.md)
+- [Finnish / Suomi](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fi.md)
+- [French / Français](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md)
+- [German /  Deutsch](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md)
+- [Hebrew/ עברית](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.he.md)
+- [Hindi / हिंदी](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hi.md)
+- [Hungarian / Magyar](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hu.md)
+- [Indonesian / Bahasa Indonesia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.id.md)
+- [Italian / Italiano](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.it.md)
+- [Japanese / 日本語](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md)
+- [Korean / 한국어](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ko.md)
+- [Malay / Bahasa Malaysia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.my.md)
+- [Malayalam / മലയാളം](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ml.md)
+- [Punjabi / ਪੰਜਾਬੀ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pa.md)
+- [Polish / Polski](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pl.md)
+- [Portuguese / Português](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pt.md)
+- [Romanian / Română](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ro.md)
+- [Russian / Русский](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md)
+- [Spanish / Español](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md)
+- [Swedish / Svenska](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.sv.md)
+- [Tamil / தமிழ்](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ta.md)
+- [Telugu / తెలుగు](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.te.md)
+- [Thai / ไทย](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.th.md)
+- [Turkish / Türkçe](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.tr.md)
+- [Ukrainian / Українська](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ua.md)
+- [Urdu / اردو](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ur.md)
+- [Vietnamese / Tiếng Việt](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.vi.md)
+
+## Links to Other READMEs
+### Backend
+- [PuterAI Module](./src/backend/doc/modules/puterai/README.md)
+- [Metering Service](./src/backend/src/services/MeteringService/README.md)
+- [Extensions Development Guide](./extensions/README.md)

doc/i18n/README.pl.md

@@ -0,0 +1,119 @@
+<h3 align="center"><img width="80" alt="Puter.com, Osobisty Komputer Chmurowy: Wszystkie twoje pliki, aplikacje i gry w jednym miejscu, dostępne z dowolnego miejsca o dowolnej porze." src="https://assets.puter.site/puter-logo.png"></h3>
+<h3 align="center"> System Operacyjny Internet! Darmowy, Open-Source i Możliwy do Samodzielnego Hostowania.</h3>
+<p align="center">
+    <img alt="Rozmiar repozytorium GitHub" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="Wydanie GitHub" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="Licencja GitHub" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« DEMO NA ŻYWO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="zrzut ekranu" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+<br/>
+
+## Puter
+
+Puter to zaawansowany, open-source'owy internetowy system operacyjny, zaprojektowany tak, aby był bogaty w funkcje, wyjątkowo szybki i wysoce rozszerzalny. Puter może być używany jako:
+
+- Prywatna chmura osobista do przechowywania wszystkich plików, aplikacji i gier w jednym bezpiecznym miejscu, dostępnym z dowolnego miejsca o dowolnej porze.
+- Platforma do budowania i publikowania stron internetowych, aplikacji webowych i gier.
+- Alternatywa dla Dropbox, Google Drive, OneDrive itp. ze świeżym interfejsem i potężnymi funkcjami.
+- Zdalne środowisko pulpitu dla serwerów i stacji roboczych.
+- Przyjazny, open-source'owy projekt i społeczność do nauki o tworzeniu stron internetowych, chmurze obliczeniowej, systemach rozproszonych i wielu innych!
+
+<br/>
+
+## Rozpoczęcie pracy
+## 💻 Lokalne środowisko developerskie
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+To uruchomi Puter na http://puter.localhost:4100 (lub na następnym dostępnym porcie).
+
+<br/>
+
+## 🐳 Docker
+
+```bash
+Copy code
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+<br/>
+
+## 🐙 Docker Compose
+## Linux/macOS
+
+```bash
+Copy code
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+## Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+## ☁️ Puter.com
+Puter jest dostępny jako usługa hostowana na  [**puter.com**](https://puter.com).
+
+<br/>
+
+## Wymagania systemowe
+
+- **Systemy operacyjne:** Linux, macOS, Windows
+- **RAM:** Minimum 2GB (zalecane 4GB)
+- **Przestrzeń dyskowa:** 1GB wolnego miejsca
+- **Node.js:** Wersja 16+ (zalecana wersja 22+)
+- **npm:** Najnowsza stabilna wersja
+
+<br/>
+
+## Wsparcie
+
+Skontaktuj się z opiekunami i społecznością przez te kanały:
+
+- Raport o błędzie lub prośba o funkcję? Proszę otworzyć zgłoszenie.
+- Discord: discord.com/invite/PQcx7Teh8u
+- X (Twitter): x.com/HeyPuter
+- Reddit: reddit.com/r/puter/
+- Mastodon: mastodon.social/@puter
+- Problemy z bezpieczeństwem? security@puter.com
+- Email do opiekunów: hi@puter.com
+
+Zawsze chętnie pomożemy Ci z wszelkimi pytaniami, jakie możesz mieć. Nie wahaj się pytać!
+<br/>
+
+## Licencja
+
+To repozytorium, w tym cała jego zawartość, podprojekty, moduły i komponenty, jest licencjonowane na podstawie [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt), chyba że wyraźnie zaznaczono inaczej. Biblioteki stron trzecich zawarte w tym repozytorium mogą podlegać własnym licencjom.
+
+<br/>
+
+
+
+
+

doc/i18n/README.pt.md

@@ -0,0 +1,173 @@
+<h3 align="center"><img width="80" alt="Puter.com, O Computador Pessoal em Nuvem: Todos os seus arquivos, aplicativos e jogos em um único lugar, acessíveis de qualquer lugar e a qualquer hora." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">O Sistema Operacional da Internet! Gratuito, de Código Aberto e Auto-Hospedável.</h3>
+
+<p align="center">
+    <a href="https://puter.com/"><strong>« DEMONSTRAÇÃO AO VIVO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://apps.puter.com/">App Store</a>
+    ·
+    <a href="https://developer.puter.com" target="_blank">Developers</a>
+    ·
+    <a href="https://github.com/heyputer/puter-cli" target="_blank">CLI</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://x.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter é um sistema operacional de internet avançado e de código aberto, projetado para ser rico em recursos, excepcionalmente rápido e altamente extensível. Puter pode ser usado como:
+
+- Um serviço de nuvem pessoal com foco na privacidade para manter todos os seus arquivos, aplicativos e jogos em um local seguro, acessível de qualquer lugar e a qualquer hora.
+- Uma plataforma para construir e publicar websites, aplicativos web e jogos.
+- Uma alternativa ao Dropbox, Google Drive, OneDrive, etc., com uma interface renovada e recursos poderosos.
+- Um ambiente de desktop remoto para servidores e estações de trabalho.
+- Um projeto e comunidade de código aberto e amigável para aprender sobre desenvolvimento web, computação em nuvem, sistemas distribuídos e muito mais!
+
+<br/>
+
+## Iniciando o Projeto
+
+
+### 💻 Desenvolvimento Local
+```
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+✨ Isso iniciará o Puter em http://puter.localhost:4100 (ou na próxima porta disponível).
+
+
+Se isso não funcionar, consulte [First Run Issues](./doc/self-hosters/first-run-issues.md) para solucionar os problemas.
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+✨ Isso iniciará o Puter em http://puter.localhost:4100 (ou na próxima porta disponível).
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+✨ Isso iniciará o Puter em http://puter.localhost:4100 (ou na próxima porta disponível).
+
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+✨ Isso iniciará o Puter em http://puter.localhost:4100 (ou na próxima porta disponível).
+
+<br/>
+
+### 🚀 Auto-Hospedagem
+
+Para guia detalhados sobre como auto-hospedar o Puter, incluindo opções de configuração e melhores práticas, consulte nossa [Documentação de Auto-Hospedagem](https://github.com/HeyPuter/puter/blob/main/doc/self-hosters/instructions.md).
+
+### ☁️ Puter.com
+
+O Puter está disponível como um serviço hospedado em [**puter.com**](https://puter.com).
+
+<br/>
+
+## Requerimentos do sistema
+
+- **Sistema operacional:** Linux, macOS, Windows
+- **RAM:** 2GB mínimo (4GB recomendado)
+- **Espaço de disco:** 1GB de espaço disponível
+- **Node.js:** Versão 16+ (Versão 23+ recomendada)
+- **npm:** Última versão estável
+
+<br/>
+
+## Suporte
+
+Conecte-se com os mantenedores e a comunidade através destes canais:
+
+- Relato de bug ou solicitação de recurso? Por favor, [abra um tópico](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Problemas de segurança? [[email protected]](mailto:[email protected])
+- Envie um email para os mantenedores em [[email protected]](mailto:[email protected])
+
+Estamos sempre felizes em ajudá-lo com quaisquer perguntas que você possa ter. Não hesite em perguntar!
+
+<br/>
+
+
+##  Licença
+
+Este repositório, incluindo todos os seus conteúdos, subprojetos, módulos e componentes, está licenciado sob [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) a menos que explicitamente indicado de outra forma. Bibliotecas de terceiros incluídas neste repositório podem estar sujeitas às suas próprias licenças.
+
+<br/>
+
+## Traduções
+
+- [Arabic / العربية](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md)
+- [Armenian / Հայերեն](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hy.md)
+- [Bengali / বাংলা](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.bn.md)
+- [Chinese / 中文](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md)
+- [Danish / Dansk](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.da.md)
+- [English](https://github.com/HeyPuter/puter/blob/main/README.md)
+- [Farsi / فارسی](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fa.md)
+- [Finnish / Suomi](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fi.md)
+- [French / Français](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md)
+- [German/ Deutsch](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md)
+- [Hebrew/ עברית](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.he.md)
+- [Hindi / हिंदी](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hi.md)
+- [Hungarian / Magyar](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hu.md)
+- [Indonesian / Bahasa Indonesia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.id.md)
+- [Italian / Italiano](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.it.md)
+- [Japanese / 日本語](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md)
+- [Korean / 한국어](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ko.md)
+- [Malayalam / മലയാളം](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ml.md)
+- [Polish / Polski](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pl.md)
+- [Portuguese / Português](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pt.md)
+- [Romanian / Română](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ro.md)
+- [Russian / Русский](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md)
+- [Spanish / Español](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md)
+- [Swedish / Svenska](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.sv.md)
+- [Tamil / தமிழ்](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ta.md)
+- [Telugu / తెలుగు](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.te.md)
+- [Thai / ไทย](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.th.md)
+- [Turkish / Türkçe](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.tr.md)
+- [Ukrainian / Українська](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ua.md)
+- [Urdu / اردو](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ur.md)
+- [Vietnamese / Tiếng Việt](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.vi.md)

doc/i18n/README.ro.md

@@ -0,0 +1,129 @@
+<h3 align="center"><img width="80" alt="Puter.com, calculatorul personal în cloud: toate fișierele, aplicațiile și jocurile tale într-un singur loc, accesibile de oriunde și oricând." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Sistemul de operare al internetului! Gratuit, open-source și găzduibil autonom.</h3>
+
+<p align="center">
+    <img alt="Dimensiunea repoului GitHub" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="Versiunea de pe GitHub" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=ultima%20versiune"> <img alt="Licență GitHub" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« DEMO LIVE »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://www.youtube.com/@EricsPuterVideos">YouTube</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+    ·
+    <a href="https://hackerone.com/puter_h1b">Program de recompense pentru identificarea bugurilor</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="captură de ecran" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter este un sistem de operare pe internet, avansat, open-source, conceput să fie bogat în funcționalități, excepțional de rapid și foarte extensibil. Puter poate fi folosit ca:
+
+* Un cloud personal cu accent pe confidențialitate, pentru a-ți păstra toate fișierele, aplicațiile și jocurile într-un singur loc securizat, accesibil de oriunde și oricând.
+* O platformă pentru a construi și publica site-uri, aplicații web și jocuri.
+* O alternativă la Dropbox, Google Drive, OneDrive etc., cu o interfață nouă și funcționalități puternice.
+* Un mediu desktop la distanță pentru servere și stații de lucru.
+* Un proiect și o comunitate, open-source și prietenoase, pentru a învăța despre dezvoltare web, cloud computing, sisteme distribuite și multe altele!
+
+<br/>
+
+## Fă primii pași
+
+### 💻 Dezvoltare locală
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Aceasta va porni Puter la [http://puter.localhost:4100](http://puter.localhost:4100) (sau pe următorul port disponibil).
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+<br/>
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+
+<br/>
+
+### ☁️ Puter.com
+
+Puter este disponibil ca serviciu găzduit la adresa [**puter.com**](https://puter.com).
+
+<br/>
+
+## Cerințe de sistem
+
+* **Sisteme de operare:** Linux, macOS, Windows
+* **RAM:** minimum 2GB (recomandat 4GB)
+* **Spațiu pe disc:** 1GB spațiu liber
+* **Node.js:** versiunea 16+ (versiunea 22+ recomandată)
+* **npm:** ultima versiune stabilă
+
+<br/>
+
+## Suport
+
+Ia legătura cu cei care asigură mentenanța proiectului și cu comunitatea prin aceste canale:
+
+* Vrei să raportezi un bug sau să ceri o funcționalitate? Te rugăm să [deschizi o problemă](https://github.com/HeyPuter/puter/issues/new/choose).
+* Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+* X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+* Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+* Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+* Probleme de securitate? [[email protected]](mailto:[email protected])
+* Trimite un e-mail celor care asigură mentenanța proiectului la [[email protected]](mailto:[email protected])
+
+Suntem întotdeauna bucuroși să te ajutăm cu orice întrebări ai. Nu ezita să ne pui întrebări!
+
+<br/>
+
+## Licență
+
+Acest repository, inclusiv tot conținutul său, subproiectele, modulele și componentele, este licențiat sub [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt), cu excepția cazurilor în care se menționează explicit altfel. Bibliotecile terțe incluse în acest repository pot fi supuse propriilor lor licențe.
+
+<br/>
+

doc/i18n/README.ru.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, персональный облачный компьютер: все ваши файлы, приложения и игры в одном месте, доступные из любой точки мира в любое время." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Интернет ОС! Бесплатная, с открытым исходным кодом и возможностью самостоятельной установки.</h3>
+
+<p align="center">
+    <img alt="Размер репозитория GitHub" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="Релиз GitHub" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="Лицензия GitHub" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« ЖИВОЕ ДЕМО »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter — это передовая операционная система с открытым исходным кодом, разработанная для обеспечения широкого функционала, исключительной скорости и высокой масштабируемости. Puter можно использовать как:
+
+- Персональное облако с приоритетом конфиденциальности для хранения всех ваших файлов, приложений и игр в одном безопасном месте, доступном из любой точки мира в любое время.
+- Платформа для создания и публикации веб-сайтов, веб-приложений и игр.
+- Альтернатива Dropbox, Google Drive, OneDrive и т. д. с новым интерфейсом и мощными функциями.
+- Удаленное рабочее окружение для серверов и рабочих станций.
+- Дружественный проект с открытым исходным кодом и сообщество для изучения веб-разработки, облачных вычислений, распределенных систем и многого другого!
+
+<br/>
+
+## Начало работы
+
+
+### 💻 Локальная разработка
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Это запустит Puter по адресу http://puter.localhost:4100 (или на следующем доступном порту).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter доступен как облачный сервис на [**puter.com**](https://puter.com).
+
+<br/>
+
+## Системные требования
+
+- **Операционные системы:** Linux, macOS, Windows
+- **ОЗУ:** минимум 2 ГБ (рекомендуется 4 ГБ)
+- **Место на диске:** 1 ГБ свободного места
+- **Node.js:** Версия 16+ (рекомендуется версия 22+)
+- **npm:** Последняя стабильная версия
+
+<br/>
+
+## Поддержка
+
+Свяжитесь с разработчиками и сообществом этими способами:
+
+- Отчет об ошибке или запрос функции? Пожалуйста, [откройте вопрос](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Проблемы безопасности? [[email protected]](mailto:[email protected])
+- Свяжитесь с разработчиками по адресу [[email protected]](mailto:[email protected])
+
+Мы всегда рады помочь вам с любыми вопросами. Не стесняйтесь спрашивать!
+
+<br/>
+
+
+## Лицензия
+
+Этот репозиторий, включая все его содержимое, подпроекты, модули и компоненты, лицензирован в соответствии с [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt), если явно не указано иное. Сторонние библиотеки, включенные в этот репозиторий, могут подпадать под действие их собственных лицензий.
+
+<br/>

doc/i18n/README.sv.md

@@ -0,0 +1,125 @@
+<h3 align="center"><img width="80" alt="Puter.com, Den personliga molndatorn: Alla dina filer, appar och spel på ett ställe tillgängliga var som helst när som helst." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Internet OS! Gratis, öppen källkod och självhostad.</h3>
+
+<p align="center">
+    <img alt="GitHub repo storlek" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Utgåva" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=senaste%20versionen"> <img alt="GitHub Licens" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« LIVE DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="skärmdump" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter är ett avancerat, öppen källkod internetoperativsystem designat för att vara funktionsrikt, exceptionellt snabbt och mycket utbyggbart. Puter kan användas som:
+
+- Ett integritetsfokuserat personligt moln för att hålla alla dina filer, appar och spel på ett säkert ställe, tillgängligt var som helst när som helst.
+- En plattform för att bygga och publicera webbplatser, webbappar och spel.
+- Ett alternativ till Dropbox, Google Drive, OneDrive, etc. med ett fräscht gränssnitt och kraftfulla funktioner.
+- En fjärrskrivbordsmiljö för servrar och arbetsstationer.
+- Ett vänligt, öppen källkod-projekt och gemenskap för att lära sig om webbutveckling, molndatorer, distribuerade system och mycket mer!
+
+<br/>
+
+## Komma igång
+
+### 💻 Lokal Utveckling
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Detta kommer att starta Puter på http://puter.localhost:4100 (eller nästa lediga port).
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+<br/>
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+
+<br/>
+
+### ☁️ Puter.com
+
+Puter är tillgängligt som en värdtjänst på [**puter.com**](https://puter.com).
+
+<br/>
+
+## Systemkrav
+
+- **Operating Systems:** Linux, macOS, Windows
+- **RAM:** 2GB minimum (4GB recommended)
+- **Disk Space:** 1GB free space
+- **Node.js:** Version 16+ (Version 22+ recommended)
+- **npm:** Latest stable version
+
+<br/>
+
+## Support
+
+Anslut med underhållarna och gemenskapen genom dessa kanaler:
+
+- Buggrapport eller funktionsförfrågan? Vänligen [öppna ett ärende](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Säkerhetsproblem? [[email protected]](mailto:[email protected])
+- E-posta underhållarna på [[email protected]](mailto:[email protected])
+
+Vi hjälper dig gärna med eventuella frågor du kan ha. Tveka inte att fråga!
+
+<br/>
+
+## Licens
+
+Detta arkiv, inklusive allt dess innehåll, delprojekt, moduler och komponenter, är licensierat under [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) om inte annat uttryckligen anges. Tredjepartsbibliotek som ingår i detta arkiv kan vara föremål för sina egna licenser.
+
+<br/>
+

doc/i18n/README.ta.md

@@ -0,0 +1,123 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: உங்கள் கோப்புகள், ஆப்ஸ் மற்றும் கேம்கள் அனைத்தும் ஒரே இடத்தில் எங்கிருந்தும் எந்த நேரத்திலும் அணுகலாம்." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">இன்டர்நெட் OS! இலவசம், ஓப்பன் சோர்ஸ் மற்றும் Self-Hostable</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub உரிமம்" src="https://img.shields.io/github/license/HeyPuter/puter" >
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« லைவ் டெமோ »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+        ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## புட்டர் (Putter)
+
+புட்டர்(putter) என்பது ஒரு மேம்பட்ட, திறந்த மூல இலவசமாக இணைய இயக்க முறைமையாகும், இது அம்சம் நிறைந்ததாகவும், விதிவிலக்காக வேகமாகவும், அதிக விரிவாக்கக்கூடியதாகவும் வடிவமைக்கப்பட்டுள்ளது. புட்டரை இவ்வாறு பயன்படுத்தலாம்:
+
+- உங்கள் கோப்புகள், பயன்பாடுகள் மற்றும் கேம்கள் அனைத்தையும் ஒரே பாதுகாப்பான இடத்தில் வைத்திருக்க, எந்த நேரத்திலும் எங்கிருந்தும் அணுகக்கூடிய தனியுரிமை-முதல் தனிப்பட்ட கிளவுட்.
+- இணையதளங்கள், இணைய பயன்பாடுகள் மற்றும் கேம்களை உருவாக்கி வெளியிடுவதற்கான தளம் இதுவாகும்.
+- புதிய இடைமுகம் மற்றும் சக்திவாய்ந்த அம்சங்களுடன் Dropbox, Google Drive, OneDrive போன்றவற்றுக்கு மாற்றீடாக உபயோகிக்க கூடியது.
+- சர்வர்கள் மற்றும் பணிநிலையங்களுக்கான தொலைநிலை டெஸ்க்டாப்(desktop) சூழல்.
+- வலை மேம்பாடு, கிளவுட் கம்ப்யூட்டிங், விநியோகிக்கப்பட்ட அமைப்புகள் மற்றும் பலவற்றைப் பற்றி அறிந்து ஒரு நட்பு ரீதியான, திறந்த மூல திட்டம் மற்றும் சமூக அறிவியலில் சார்ந்த ஒன்று.
+
+<br/>
+
+## தொடங்குதல்
+
+### 💻 உள்ளூர் வளர்ச்சி
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+``` தொடக்கம்
+```
+
+இது புட்டரை <http://puter.localhost:4100> இல் தொடங்கும் (அல்லது அடுத்து கிடைக்கும் இடம்).
+
+<br/>
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+### 🐙 டோக்கர் கம்போஸ்
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+புட்டர் ஹோஸ்ட் செய்யப்பட்ட சேவையாக [**puter.com**](https://puter.com) இல் கிடைக்கிறது.
+
+<br/>
+
+## கணினி தேவைகள்
+
+- **இயக்க முறைமைகள்:** Linux, macOS, Windows
+- **ரேம்:** குறைந்தபட்சம் 2 ஜிபி (4 ஜிபி பரிந்துரைக்கப்படுகிறது)
+- **வட்டு இடம்:** 1GB இலவச இடம்
+- **Node.js:** Version 16+ (Version 22+ recommended)
+- **npm:** சமீபத்திய நிலையான பதிப்பு(Latest stable version)
+
+<br/>
+
+## ஆதரவு
+
+இந்த சேனல்கள் மூலம் பராமரிப்பாளர்கள் மற்றும் சமூகத்துடன் சமூக இணைப்பாளர்:
+
+- பிழை அறிக்கை அல்லது மாற்றுதல் கோரிக்கை? தயவுசெய்து [சிக்கலைத் திறக்கவும்](https://github.com/HeyPuter/puter/issues/new/choose).
+- கருத்து வேறுபாடு: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter):  [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- பாதுகாப்பு பிரச்சினைகள்? [[email protected]](mailto:[email protected])
+- மின்னஞ்சல் பராமரிப்பாளர்களுக்கு [[email protected]](mailto:[email protected])
+
+உங்களுக்கு ஏதேனும் கேள்விகள் இருந்தால் உங்களுக்கு உதவ நாங்கள் எப்போதும் மகிழ்ச்சியடைகிறோம். தயங்காமல் கேளுங்கள்!
+
+<br/>
+
+## உரிமம்
+
+இந்தக் களஞ்சியமானது, அதன் அனைத்து உள்ளடக்கங்கள், துணைத் திட்டங்கள், தொகுதிகள் மற்றும் கூறுகள் உட்பட, வெளிப்படையாகக் கூறப்படாவிட்டால், [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) இன் கீழ் உரிமம் பெற்றுள்ளது. . இந்தக் களஞ்சியத்தில் சேர்க்கப்பட்டுள்ள மூன்றாம் தரப்பு நூலகங்கள் அவற்றின் சொந்த உரிமங்களுக்கு உட்பட்டதாக இருக்கும்.
+
+<br/>

doc/i18n/README.te.md

@@ -0,0 +1,161 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: మీ అన్ని ఫైల్‌లు, యాప్‌లు మరియు గేమ్‌లను ఒకే స్థలంలో ఎక్కడి నుండైనా ఎప్పుడైనా యాక్సెస్ చేయవచ్చు." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center"> ఇంటర్నెట్ OS! ఉచిత, ఓపెన్ సోర్స్, and Self-Hostable.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« ప్రత్యక్ష ప్రదర్శన »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## పుటర్ (Puter)
+
+పుటర్ అనేది అధునాతన, ఓపెన్ సోర్స్ ఇంటర్నెట్ ఆపరేటింగ్ సిస్టమ్, ఇది ఫీచర్-రిచ్, అనూహ్యంగా వేగవంతమైన మరియు అత్యంత విస్తరించదగినదిగా రూపొందించబడింది. పుటర్‌ను ఇలా ఉపయోగించవచ్చు:
+
+- మీ అన్ని ఫైల్‌లు, యాప్‌లు మరియు గేమ్‌లను ఒకే సురక్షిత స్థలంలో ఉంచడానికి గోప్యత-మొదటి వ్యక్తిగత క్లౌడ్, ఎప్పుడైనా ఎక్కడి నుండైనా యాక్సెస్ చేయవచ్చు.
+- వెబ్‌సైట్‌లు, వెబ్ యాప్‌లు మరియు గేమ్‌లను రూపొందించడానికి మరియు ప్రచురించడానికి ఒక వేదిక.
+- తాజా ఇంటర్‌ఫేస్ మరియు శక్తివంతమైన ఫీచర్‌లతో Dropbox, Google Drive, OneDrive మొదలైన వాటికి ప్రత్యామ్నాయం.
+- సర్వర్లు మరియు వర్క్‌స్టేషన్‌ల కోసం రిమోట్ డెస్క్‌టాప్ వాతావరణం.
+- వెబ్ డెవలప్‌మెంట్, క్లౌడ్ కంప్యూటింగ్, డిస్ట్రిబ్యూట్ సిస్టమ్‌లు మరియు మరిన్నింటి గురించి తెలుసుకోవడానికి స్నేహపూర్వక, ఓపెన్ సోర్స్ ప్రాజెక్ట్ మరియు కమ్యూనిటీ!
+
+<br/>
+
+## ప్రారంభించడం
+
+### లోకల్ డెవలప్మెంట్
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+ఇది http://puter.localhost:4100 (లేదా తదుపరి అందుబాటులో ఉన్న పోర్ట్) వద్ద పుటర్‌ని ప్రారంభిస్తుంది.
+
+ఇది పని చేయకపోతే, దీని కోసం [మొదటి రన్ సమస్యలు](./doc/first-run-issues.md) చూడండి
+ట్రబుల్షూటింగ్ దశలు.
+
+<br/>
+
+### 🐳 డోకర్
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+### 🐙 డోకర్ Compose
+
+#### లినక్స్/ macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+<br/>
+
+#### విండోస్
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+
+<br/>
+
+### ☁️ Puter.com
+
+పుటర్ [**puter.com**](https://puter.com)లో హోస్ట్ చేయబడి ఉంది.
+
+<br/>
+
+## System Requirements
+
+- **ఆపరేటింగ్ సిస్టమ్స్:** లినక్స్, macOS, విండోస్
+- **RAM:** 2GB కనీసం(4GB recommended)
+- **Disk Space:** 1GB ఖాళీ
+- **Node.js:** Version 16+ (Version 22+ recommended)
+- **npm:** Latest stable version
+
+<br/>
+
+## Support
+
+ఈ ఛానెల్‌ల ద్వారా నిర్వాహకులు మరియు సంఘంతో కనెక్ట్ అవ్వండి:
+
+- బగ్ నివేదిక లేదా ఫీచర్ అభ్యర్థన? దయచేసి [open an issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Security issues? [[email protected]](mailto:[email protected])
+- Email maintainers at [[email protected]](mailto:[email protected])
+
+మీకు ఏవైనా సందేహాలు ఉంటే మీకు సహాయం చేయడానికి మేము ఎల్లప్పుడూ సంతోషిస్తాము. అడగడానికి సంకోచించకండి!
+
+<br/>
+
+## లైసెన్సు
+
+ఈ రిపోజిటరీ, దాని మొత్తం కంటెంట్‌లు, ఉప-ప్రాజెక్ట్‌లు, మాడ్యూల్స్ మరియు కాంపోనెంట్‌లతో సహా, [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) కింద లైసెన్స్‌ని కలిగి ఉంటుంది. . ఈ రిపోజిటరీలో చేర్చబడిన థర్డ్-పార్టీ లైబ్రరీలు వాటి స్వంత లైసెన్స్‌లకు లోబడి ఉండవచ్చు.
+
+<br/>
+
+## అనువాదాలు
+
+- [Arabic / العربية](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md)
+- [Armenian / Հայերեն](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hy.md)
+- [Bengali / বাংলা](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.bn.md)
+- [Chinese / 中文](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md)
+- [Danish / Dansk](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.da.md)
+- [English](https://github.com/HeyPuter/puter/blob/main/README.md)
+- [Farsi / فارسی](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fa.md)
+- [Finnish / Suomi](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fi.md)
+- [French / Français](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md)
+- [German/ Deutsch](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md)
+- [Hebrew/ עברית](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.he.md)
+- [Hindi / हिंदी](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hi.md)
+- [Hungarian / Magyar](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hu.md)
+- [Indonesian / Bahasa Indonesia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.id.md)
+- [Italian / Italiano](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.it.md)
+- [Japanese / 日本語](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md)
+- [Korean / 한국어](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ko.md)
+- [Malayalam / മലയാളം](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ml.md)
+- [Polish / Polski](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pl.md)
+- [Portuguese / Português](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pt.md)
+- [Romanian / Română](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ro.md)
+- [Russian / Русский](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md)
+- [Spanish / Español](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md)
+- [Swedish / Svenska](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.sv.md)
+- [Tamil / தமிழ்](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ta.md)
+- [Telugu / తెలుగు](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.te.md)
+- [Thai / ไทย](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.th.md)
+- [Turkish / Türkçe](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.tr.md)
+- [Ukrainian / Українська](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ua.md)
+- [Urdu / اردو](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ur.md)
+- [Vietnamese / Tiếng Việt](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.vi.md)

doc/i18n/README.th.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">ระบบปฏิบัติการอินเทอร์เน็ต ฟรี, โอเพ่นซอร์ส, และสามารถโฮสต์ได้ด้วยตนเอง</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« การสาธิตสด »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">ชุดพัฒนาโปรแกรม</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">ดิสคอร์ด</a>
+    ·
+    <a href="https://reddit.com/r/puter">เรดดิท</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (ทวิตเตอร์)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## พิวเตอร์
+
+พิวเตอร์ เป็นระบบปฏิบัติการอินเทอร์เน็ตขั้นสูงแบบโอเพ่นซอร์สที่ออกแบบมาให้มีฟีเจอร์ครบถ้วน ความเร็วสูง และมีความสามารถที่จะขยายได้สูง. พิวเตอร์ สามารถใช้ได้เป็น:
+
+- คลาวด์ส่วนตัว เพื่อเก็บไฟล์, แอพพลิเคชัน, และเกมทั้งหมดของคุณในที่เดียวที่ปลอดภัยและสามารถเข้าถึงได้ทุกที่ทุกเวลา
+- แพลตฟอร์มสำหรับการสร้างและเผยแพร่เว็บไซต์, เว็บแอปพลิเคชัน, และเกม
+- ทางเลือกอีกหนึ่งทางที่สามารถใช้แทน Dropbox, Google Drive, OneDrive ฯลฯ โดยที่มีอินเทอร์เฟซใหม่และฟีเจอร์ที่ทรงพลัง
+- สภาพแวดล้อมสำหรับเดสก์ท็อประยะไกลที่ใช้กับเซิร์ฟเวอร์และสถานีทำงาน
+- โครงการโอเพ่นซอร์สและชุมชนที่เป็นมิตรที่คุณสามารถเรียนรู้เกี่ยวกับการพัฒนาเว็บ, คลาวด์คอมพิวติ้ง, ระบบกระจาย, และอีกมากมาย
+
+<br/>
+
+## การเริ่มต้นใช้งาน
+
+
+### 💻 การพัฒนาภายในเครื่อง
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+พิวเตอร์ จะถูกเปิดใช้งานที่ http://puter.localhost:4100 (หรือพอร์ตถัดไปที่ว่าง).
+
+<br/>
+
+### 🐳 ด็อกเกอร์
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 ด็อกเกอร์ คอมโพส
+
+
+#### ลินุกซ์/แมคโอเอส
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### วินโดวส์
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+สามารถใช้งาน พิวเตอร์ ได้ในรูปแบบบริการโฮสต์ที่ [**puter.com**](https://puter.com).
+
+<br/>
+
+## ข้อกำหนดของระบบ
+
+- **ระบบปฏิบัติการ:** ลินุกซ์ แมคโอเอส วินโดวส์
+- **แรม:** อย่างน้อย 2GB (แนะนำ 4GB)
+- **พื้นที่เก็บข้อมูล:** พื้นที่ว่าง 1GB
+- **Node.js:** เวอร์ชัน 16+ (แนะนำเวอร์ชัน 22+)
+- **npm:** เวอร์ชันล่าสุดที่เสถียร
+
+<br/>
+
+## การช่วยเหลือ
+
+ติดต่อกับผู้ดูแลระบบและชุมชนผ่านช่องทางเหล่านี้:
+
+- พบข้อผิดพลาดหรือขอฟีเจอร์ใหม่? กรุณา [เปิดปัญหา](https://github.com/HeyPuter/puter/issues/new/choose).
+- ดิสคอร์ด: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (ทวิตเตอร์): [x.com/HeyPuter](https://x.com/HeyPuter)
+- เรดดิท: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- มาสตอดอน: [mastodon.social/@puter](https://mastodon.social/@puter)
+- ปัญหาด้านความปลอดภัย [[email protected]](mailto:[email protected])
+- ส่งอีเมลถึงผู้ดูแลระบบได้ที่ [[email protected]](mailto:[email protected])
+
+เรายินดีเสมอที่จะช่วยเหลือคุณกับทุกทุกคำถามที่คุณมี อย่าลังเลที่จะถาม
+
+<br/>
+
+
+##  ลิขสิทธิ์
+
+ที่เก็บข้อมูลนี้ รวมถึงเนื้อหาทั้งหมด, โครงการย่อย, โมดูล, และส่วนประกอบต่างๆ ได้รับใบอนุญาตภายใต้ [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt)  เว้นแต่จะมีการระบุไว้เป็นอย่างอื่นอย่างชัดเจน ไลบรารีจากบุคคลที่สามที่รวมอยู่ในที่เก็บข้อมูลนี้อาจอยู่ภายใต้ใบอนุญาตของตนเอง
+
+<br/>

doc/i18n/README.tr.md

@@ -0,0 +1,127 @@
+<h3 align="center"><img width="80" alt="Puter.com, Kişisel Bulut Bilgisayar: Tüm dosyalarınız, uygulamalarınız ve oyunlarınız her zaman her yerden erişilebilen tek bir yerde." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">İnternet İşletim Sistemi! Ücretsiz, Açık Kaynaklı ve Kendi Kendine Barındırılabilir</h3>
+
+<p align="center">
+    <img alt="GitHub Depo Boyutu" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Yayınlamak" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub Lisans" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« CANLI DEMO »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter, zengin özelliklere sahip, son derece hızlı ve son derece genişletilebilir olacak şekilde tasarlanmış gelişmiş, açık kaynaklı bir internet işletim sistemidir. Puter şu şekilde kullanılabilir:
+
+- Tüm dosyalarınızı, uygulamalarınızı ve oyunlarınızı tek bir güvenli yerde tutmak için gizlilik öncelikli bir kişisel bulut, her yerden her zaman erişilebilir.
+- Web siteleri, web uygulamaları ve oyunlar oluşturmak ve yayınlamak için bir platform.
+- Yeni bir arayüz ve güçlü özelliklerle Dropbox, Google Drive, OneDrive vb. uygulamalara bir alternatif.
+- Sunucular ve iş istasyonları için bir uzak masaüstü ortamı.
+- Web geliştirme, bulut bilişim, dağıtık sistemler ve çok daha fazlası hakkında bilgi edinmek için dost canlısı, açık kaynaklı bir proje ve topluluk!
+
+<br/>
+
+## Başlarken
+
+
+### 💻 Yerel Geliştirme
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Bu, Puter'ı http://puter.localhost:4100 adresinde (veya bir sonraki kullanılabilir portta) başlatacaktır.
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter, [**puter.com**](https://puter.com) adresinde barındırılan bir hizmet olarak kullanılabilir.
+
+<br/>
+
+## Sistem Gereksinimleri
+
+- **İşletim Sistemleri:** Linux, macOS, Windows
+- **RAM:** 2GB Minimum (4GB önerilir)
+- **Disk Alanı:** 1GB boş alan
+- **Node.js:** Sürüm 16+ (Sürüm 22+ önerilir)
+- **npm:** En son stabil sürüm
+
+<br/>
+
+## Destek
+
+Bakımcılarla ve toplulukla şu kanallar aracılığıyla iletişim kurabilirsiniz:
+
+- Hata raporu veya özellik isteği? Lütfen [yeni bir issue açın](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Güvenlik sorunları? [[email protected]](mailto:[email protected])
+- Bakımcılara şu adresten e-posta gönderin [[email protected]](mailto:[email protected])
+
+Sorularınız varsa size her zaman yardımcı olmaktan mutluluk duyarız. Sormaktan çekinmeyin!
+
+<br/>
+
+
+##  Lisans
+
+Bu depo, tüm içeriği, alt projeleri, modülleri ve bileşenleri dahil olmak üzere, aksi açıkça belirtilmedikçe [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) altında lisanslanmıştır. Bu depoda yer alan üçüncü taraf kütüphaneler kendi lisanslarına tabi olabilir.
+
+<br/>

doc/i18n/README.ua.md

@@ -0,0 +1,125 @@
+<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: Всі ваші файли, додатки та ігри в одному місці, доступні з будь-якого куточка світу в будь-який час." src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">Інтернет ОС! Безкоштовна, відкрита та self-hosted.</h3>
+
+<p align="center">
+    <img alt="Розмір репозиторію на GitHub" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="Остання версія на GitHub" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="Ліцензія GitHub" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« Онлайн ДЕМО »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="скріншот" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter — це просунута, інтернет-ОС, з відкритим кодом, створена для того, щоб бути багатофункціональною, надзвичайно швидкою та розширюваною. Puter може використовуватися як:
+
+- Приватний хмарний сервіс для збереження всіх ваших файлів, додатків і ігор у безпечному місці, доступному в будь-який час з будь-якого місця.
+- Платформа для створення та публікації вебсайтів, вебдодатків і ігор.
+- Альтернатива Dropbox, Google Drive, OneDrive і тд, з свіженьким інтерфейсом та потужними функціями.
+- Віддалене робоче середовище для серверів і робочих станцій.
+- Дружній, відкритий проєкт та спільнота для вивчення веброзробки, хмарних обчислень, розподілених систем і багато іншого!
+
+<br/>
+
+## Початок роботи
+
+### Локальна розробка
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Це запустить Puter на http://puter.localhost:4100 (або на наступному доступному порті).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter доступний як hosted service на [**puter.com**](https://puter.com).
+
+<br/>
+
+## Системні вимоги
+
+- **Операційні Системи:** Linux, macOS, Windows
+- **RAM:** 2GB мінімум (4GB рекомендовано)
+- **Місце на диску:** 1GB вільного місця
+- **Node.js:** Version 16+ (Version 22+ рекомендовано)
+- **npm:** остання "stable" версія
+
+<br/>
+
+## Підтримка
+
+Зв'язатися з розробниками та спільнотою можна через такі канали:
+
+- Повідомити про помилку, або запит щодо нової фічі? Будь ласка, [створіть issue](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Питання щодо Security? [[email protected]](mailto:[email protected])
+- Написати розробникам [[email protected]](mailto:[email protected])
+
+Ми завжди готові допомогти Вам з будь-якими питаннями, що можуть виникнути. Не соромтеся ставити нам питання!
+<br/>
+
+
+##  License
+
+Цей репорзиторій, включаючи увесь його контент, дочірні проєкти, модулі, і компоненти, ліцензовано за [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt), якщо явно не вказано інше. Сторонні бібліотеки, включені в цей репозиторій, можуть підпадати під дію інших ліцензій.
+
+<br/>

doc/i18n/README.ur.md

@@ -0,0 +1,121 @@
+<h3 align="center"><img width="80" alt="Puter.com, ذاتی کلاؤڈ کمپیوٹر: آپ کی تمام فائلیں، ایپس، اور کھیل ایک جگہ پر، کہیں سے بھی اور کسی بھی وقت قابل رسائی۔" src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">انٹرنیٹ OS! مفت، اوپن سورس، اور خود میزبان.</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« لائیو ڈیمو »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">ڈسکورڈ</a>
+    ·
+    <a href="https://reddit.com/r/puter">ریڈڈٹ</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">ایکس (ٹوئٹر)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="اسکرین شاٹ" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+ایک جدید، اوپن سورس انٹرنیٹ آپریٹنگ سسٹم ہے جو کہ خصوصیات سے بھرپور، بہت تیز، اور انتہائی توسیع پذیر ہے۔ Puter 
+
+: کو استعمال کیا جا سکتا ہے Puter
+
+- ایک پرائیویسی فرسٹ ذاتی کلاؤڈ کے طور پر تاکہ آپ کی تمام فائلیں، ایپس، اور کھیل ایک محفوظ جگہ پر رکھی جا سکیں، کہیں سے بھی اور کسی بھی وقت قابل رسائی ہوں۔
+- ویب سائٹس، ویب ایپس، اور کھیل بنانے اور شائع کرنے کے لئے ایک پلیٹ فارم کے طور پر۔
+- وغیرہ کا متبادل، نئے انٹرفیس اور طاقتور خصوصیات کے ساتھ۔ Dropbox، Google Drive، OneDrive 
+- سرورز اور ورک اسٹیشنز کے لیے ایک ریموٹ ڈیسک ٹاپ ماحول کے طور پر۔
+- ویب ڈویلپمنٹ، کلاؤڈ کمپیوٹنگ، تقسیم شدہ نظاموں، اور بہت کچھ سیکھنے کے لیے ایک دوستانہ، اوپن سورس پروجیکٹ اور کمیونٹی!
+
+<br/>
+
+## شروع کرنے کا طریقہ
+
+### 💻 مقامی ترقی
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+یہ Puter کو http://puter.localhost:4100 (یا اگلے دستیاب پورٹ) پر لانچ کرے گا۔
+
+<br/>
+🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+🐙 Docker Compose
+Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+<br/>
+Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+### ☁️ Puter.com
+
+Puter کو [**puter.com**](https://puter.com) پر میزبان سروس کے طور پر دستیاب ہے۔
+
+<br/>
+
+## نظام کی ضروریات
+
+- **آپریٹنگ سسٹمز:** لینکس، macOS، ونڈوز
+- **RAM:** کم از کم 2GB (4GB تجویز کردہ)
+- **ڈسک کی جگہ:** 1GB خالی جگہ
+- **Node.js:** ورژن 16+ (ورژن 22+ تجویز کردہ)
+- **npm:** تازہ ترین مستحکم ورژن
+
+<br/>
+
+## سپورٹ
+
+منتظمین اور کمیونٹی سے جڑنے کے لیے یہ چینلز استعمال کریں:
+
+- بگ رپورٹ یا فیچر درخواست؟ براہ کرم [ایک مسئلہ کھولیں](https://github.com/HeyPuter/puter/issues/new/choose).
+- ڈسکورڈ: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- ایکس (ٹوئٹر): [x.com/HeyPuter](https://x.com/HeyPuter)
+- ریڈڈٹ: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- ماسٹڈون: [mastodon.social/@puter](https://mastodon.social/@puter)
+- سیکیورٹی کے مسائل؟ [[email protected]](mailto:[email protected])
+- منتظمین کو ای میل کریں [[email protected]](mailto:[email protected])
+
+ہم ہمیشہ آپ کی مدد کے لیے خوش ہیں۔ سوالات پوچھنے میں ہچکچاہٹ نہ کریں 
+!
+<br/>
+
+## لائسنس
+
+اس ریپوزٹری، بشمول اس کے تمام مواد، ذیلی پروجیکٹس، ماڈیولز، اور کمپوننٹس، کو [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) کے تحت لائسنس کیا گیا ہے جب تک کہ واضح طور پر کہیں اور نہ کہا گیا ہو۔ اس ریپوزٹری میں شامل تھرڈ پارٹی لائبریریاں اپنی لائسنس کے تابع ہو سکتی ہیں۔
+
+<br/>

doc/i18n/README.vi.md

@@ -0,0 +1,125 @@
+<h3 align="center"><img width="80" alt="Puter.com, Máy Tính Đám Mây Cá Nhân: Tất cả các tệp, ứng dụng, và trò chơi của bạn ở một nơi, có thể truy cập từ bất cứ đâu vào bất kỳ lúc nào." src="https://assets.puter.site/puter-logo.png"></h3>
+<h3 align="center">Hệ điều hành Internet! Miễn phí, Mã nguồn mở và Có thể tự lưu trữ.</h3>
+<p align="center">
+    <img alt="Kích thước repo GitHub" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="Phiên bản phát hành GitHub" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=Phi%C3%AAn%20b%E1%BA%A3n%20ph%C3%A1t%20h%C3%A0nh%20GitHub"> <img alt="Giấy phép GitHub" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+<p align="center">
+    <a href="https://puter.com/"><strong>« DEMO TRỰC TIẾP »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="chụp màn hình" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter là một hệ điều hành internet tiên tiến, mã nguồn mở được thiết kế để có nhiều tính năng, tốc độ vượt trội và khả năng mở rộng cao. Puter có thể được sử dụng như:
+
+- Một đám mây cá nhân ưu tiên quyền riêng tư để lưu trữ tất cả các tệp, ứng dụng và trò chơi của bạn ở một nơi an toàn, có thể truy cập từ bất cứ đâu, bất cứ lúc nào.
+- Một nền tảng để xây dựng và xuất bản các trang web, ứng dụng web và trò chơi.
+- Một sự thay thế cho Dropbox, Google Drive, OneDrive, v.v. với giao diện mới mẻ và nhiều tính năng mạnh mẽ.
+- Một môi trường máy tính từ xa cho các máy chủ và máy trạm.
+- Một dự án thân thiện, mã nguồn mở và cộng đồng để học hỏi về phát triển web, điện toán đám mây, hệ thống phân tán và nhiều hơn nữa!
+
+<br/>
+
+## Bắt Đầu
+
+## 💻 Phát Triển Cục Bộ
+
+```bash
+Copy code
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+Điều này sẽ khởi chạy Puter tại http://puter.localhost:4100 (hoặc cổng kế tiếp có sẵn).
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+Copy code
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+## 🐙 Docker Compose
+
+## Linux/macOS
+
+``` bash
+Copy code
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+<br/>
+
+## Windows
+
+```powershell
+Copy code
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+## ☁️ Puter.com
+
+Puter có sẵn dưới dạng dịch vụ lưu trữ tại [**puter.com**](https://puter.com).
+
+<br/>
+
+## Yêu Cầu Hệ Thống
+
+- **Hệ Điều Hành:** Linux, macOS, Windows
+- **RAM:** Tối thiểu 2GB (Khuyến nghị 4GB)
+- **Dung Lượng Ổ Cứng:** Còn trống 1GB
+- **Node.js:** Phiên bản 16+ (Khuyến nghị phiên bản 22+)
+- **npm:** Phiên bản ổn định mới nhất
+
+<br/>
+
+## Hỗ Trợ
+
+Kết nối với các nhà bảo trì và cộng đồng thông qua các kênh sau:
+
+- Báo cáo lỗi hoặc yêu cầu tính năng? Vui lòng mở một vấn đề.
+- Discord: discord.com/invite/PQcx7Teh8u
+- X (Twitter): x.com/HeyPuter
+- Reddit: reddit.com/r/puter/
+- Mastodon: mastodon.social/@puter
+- Vấn đề bảo mật? security@puter.com
+- Email các nhà bảo trì tại hi@puter.com
+
+Chúng tôi luôn sẵn sàng giúp đỡ bạn với bất kỳ câu hỏi nào bạn có. Đừng ngần ngại hỏi!
+
+<br/>
+
+## Giấy Phép
+
+Kho lưu trữ này, bao gồm tất cả nội dung, dự án con, mô-đun và thành phần của nó, được cấp phép theo [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt), trừ khi được tuyên bố rõ ràng khác. Các thư viện của bên thứ ba được bao gồm trong kho lưu trữ này có thể phải tuân theo các giấy phép riêng của chúng.
+
+<br/>

doc/i18n/README.zh.md

@@ -0,0 +1,138 @@
+
+<h3 align="center"><img width="80" alt="Puter.com，个人云计算机：所有文件、应用程序和游戏在一个地方，随时随地可访问。" src="https://assets.puter.site/puter-logo.png"></h3>
+
+<h3 align="center">互联网操作系统！免费、开源且可自行托管。</h3>
+
+<p align="center">
+    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/HeyPuter/puter"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/HeyPuter/puter?label=latest%20version"> <img alt="GitHub License" src="https://img.shields.io/github/license/HeyPuter/puter">
+</p>
+
+<p align="center">
+    <a href="https://puter.com/"><strong>« 在线演示 »</strong></a>
+    <br />
+    <br />
+    <a href="https://puter.com">Puter.com</a>
+    ·
+    <a href="https://docs.puter.com" target="_blank">SDK</a>
+    ·
+    <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
+    ·
+    <a href="https://reddit.com/r/puter">Reddit</a>
+    ·
+    <a href="https://twitter.com/HeyPuter">X (Twitter)</a>
+</p>
+
+<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
+
+<br/>
+
+## Puter
+
+Puter 是一个先进的开源互联网操作系统，设计为功能丰富、速度极快且高度可扩展。Puter 可用作：
+
+- 一个以隐私为优先的个人云，将所有文件、应用程序和游戏保存在一个安全的地方，随时随地可访问。
+- 构建和发布网站、Web 应用程序和游戏的平台。
+- Dropbox、Google Drive、OneDrive 等的替代品，具有全新的界面和强大的功能。
+- 服务器和工作站的远程桌面环境。
+- 一个友好的开源项目和社区，学习 Web 开发、云计算、分布式系统等更多内容！
+
+<br/>
+
+## 入门指南
+
+
+### 💻 本地开发
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+这将会在 http://puter.localhost:4100（或下一个可用端口）启动 Puter。
+
+<br/>
+
+### 🐳 Docker
+
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter
+```
+
+<br/>
+
+
+### 🐙 Docker Compose
+
+
+#### Linux/macOS
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+<br/>
+
+#### Windows
+
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+<br/>
+
+## 宝塔面板Docker一键部署（推荐）
+
+1. 安装宝塔面板9.2.0及以上版本，前往 [宝塔面板](https://www.bt.cn/new/download.html?r=dk_puter) 官网，选择正式版的脚本下载安装
+
+2. 安装后登录宝塔面板，在左侧菜单栏中点击 `Docker`，首次进入会提示安装`Docker`服务，点击立即安装，按提示完成安装
+
+3. 安装完成后在应用商店中搜索`puter`，点击安装，配置域名等基本信息即可完成安装
+   
+
+### ☁️ Puter.com
+
+Puter 可以作为托管服务使用，访问 [**puter.com**](https://puter.com)。
+
+<br/>
+
+## 系统要求
+
+- **操作系统：** Linux, macOS, Windows
+- **内存：** 最低 2GB（推荐 4GB）
+- **磁盘空间：** 1GB 可用空间
+- **Node.js：** 版本 16+（推荐 22+）
+- **npm：** 最新稳定版本
+
+<br/>
+
+## 支持
+
+通过以下渠道与维护者和社区联系：
+
+- 有 Bug 报告或功能请求？请 [提交问题](https://github.com/HeyPuter/puter/issues/new/choose)。
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- 安全问题？请联系 [[email protected]](mailto:[email protected])
+- 电子邮件维护者 [[email protected]](mailto:[email protected])
+
+我们随时乐意帮助您解答任何问题，欢迎随时联系！
+
+<br/>
+
+
+## 许可证
+
+本仓库，包括其所有内容、子项目、模块和组件，除非另有明确说明，否则均遵循 [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt) 许可证。 本仓库中包含的第三方库可能受其各自的许可证约束。
+
+<br/>

doc/license_header.txt

@@ -1,4 +1,4 @@
-Copyright (C) 2024 Puter Technologies Inc.
+Copyright (C) 2024-present Puter Technologies Inc.
 
 This file is part of Puter.
 

doc/prod.md

@@ -1,137 +0,0 @@
-# Puter in Production
-
-## Building
-    
-```bash
-npm run build
-```
-
-## Usage
-
-Will build Puter in the `dist` directory. Include the generated `./dist/gui.js` file in your HTML page and call `gui()` when the page is loaded:
-
-```html
-<script type="text/javascript" src="./dist/gui.js"></script>
-<script type="text/javascript">
-    window.addEventListener('load', function() {
-        // Initialize the GUI. All options are optional!
-        gui({
-            // The origin of the app. This is the base URL of the GUI. 
-            gui_origin: "https://puter.com",
-
-            // The origin of the API. This is the base URL of the API endpoints that the GUI will call for all its operations.
-            api_origin: "https://api.puter.com",
-
-            // The domain under which user websites are hosted.
-            hosting_domain: "puter.site",
-
-            // The maximum length of file/directory names.
-            max_item_name_length: 500,
-
-            // If GUI has to enforce email verification before allowing user to publish a website.
-            require_email_verification_to_publish_website: true,
-        })
-    });
-</script>
-```
-
-## Full Production Example
-
-Assuming the following directory structure in production:
-
-```
-.
-├── dist/
-│   ├── favicons/
-│   ├── images/
-│   ├── bundle.min.css
-│   ├── bundle.min.js
-│   ├── gui.js
-│   └── ...
-└── index.html
-```
-
-The `index.html` file below will load Puter and all the necessary meta tags, favicons, and branding assets:
-
-```html
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
-    <title>Puter</title>
-    <meta name="author" content="Puter Technologies Inc.">
-    <meta name="description" content="Puter is a privacy-first personal cloud to keep all your files, apps, and games in one private and secure place, accessible from anywhere at any time.">
-    <meta name="facebook-domain-verification" content="e29w3hjbnnnypf4kzk2cewcdaxym1y" />
-    <link rel="canonical" href="https://puter.com">
-
-    <!-- Meta meta tags -->
-    <meta property="og:url" content="https://puter.com">
-    <meta property="og:type" content="website">
-    <meta property="og:title" content="Puter">
-    <meta property="og:description" content="Puter is a privacy-first personal cloud to keep all your files, apps, and games in one private and secure place, accessible from anywhere at any time.">
-    <meta property="og:image" content="./dist/images/screenshot.png">
-
-    <!-- Twitter meta tags -->
-    <meta name="twitter:card" content="summary_large_image">
-    <meta property="twitter:domain" content="puter.com">
-    <meta property="twitter:url" content="https://puter.com">
-    <meta name="twitter:title" content="Puter">
-    <meta name="twitter:description" content="Puter is a privacy-first personal cloud to keep all your files, apps, and games in one private and secure place, accessible from anywhere at any time.">
-    <meta name="twitter:image" content="./dist/images/screenshot.png">
-
-    <!-- favicons -->
-    <link rel="apple-touch-icon" sizes="57x57" href="./dist/favicons/apple-icon-57x57.png">
-    <link rel="apple-touch-icon" sizes="60x60" href="./dist/favicons/apple-icon-60x60.png">
-    <link rel="apple-touch-icon" sizes="72x72" href="./dist/favicons/apple-icon-72x72.png">
-    <link rel="apple-touch-icon" sizes="76x76" href="./dist/favicons/apple-icon-76x76.png">
-    <link rel="apple-touch-icon" sizes="114x114" href="./dist/favicons/apple-icon-114x114.png">
-    <link rel="apple-touch-icon" sizes="120x120" href="./dist/favicons/apple-icon-120x120.png">
-    <link rel="apple-touch-icon" sizes="144x144" href="./dist/favicons/apple-icon-144x144.png">
-    <link rel="apple-touch-icon" sizes="152x152" href="./dist/favicons/apple-icon-152x152.png">
-    <link rel="apple-touch-icon" sizes="180x180" href="./dist/favicons/apple-icon-180x180.png">
-    <link rel="icon" type="image/png" sizes="192x192"  href="./dist/favicons/android-icon-192x192.png">
-    <link rel="icon" type="image/png" sizes="32x32" href="./dist/favicons/favicon-32x32.png">
-    <link rel="icon" type="image/png" sizes="96x96" href="./dist/favicons/favicon-96x96.png">
-    <link rel="icon" type="image/png" sizes="16x16" href="./dist/favicons/favicon-16x16.png">
-    <link rel="manifest" href="./dist/manifest.json">
-    <meta name="msapplication-TileColor" content="#ffffff">
-    <meta name="msapplication-TileImage" content="./dist/favicons/ms-icon-144x144.png">
-    <meta name="theme-color" content="#ffffff">
-
-    <!-- Preload images when applicable -->
-    <link rel="preload" as="image" href="./dist/images/wallpaper.webp">
-</head>
-
-<body>
-    <!-- Load the GUI script -->
-    <script type="text/javascript" src="./dist/gui.js"></script>    
-    <!-- Initialize GUI when document is loaded -->
-    <script type="text/javascript">
-    window.addEventListener('load', function() {
-        gui()
-    });
-    </script>
-</body>
-
-</html>
-```
-
-### Server settings
-
-The GUI is a single page application (SPA) and as best practice any route under root (`/*`) should preferably load the `index.html` file. However, there are situations where we want to load a custom page for a specific route: for example, the `/privacy` route may need to load a page that contains your privacy policy and has nothing to do with the GUI application. In these cases it is ok to load a custom page as long as the following essential GUI routes are loaded with the GUI (i.e. `index.html` file):
-- `/app/*`
-- `/action/*`
-
-In other words, consider the routes above as "reserved" for Puter.
-
-### Best Practices
-
-- The `title` tags and meta tags (`<title></title>`, `<meta property="og:title"`, `<meta name="twitter:title"`, ...) should be dynamically set by the server. For example, if the URL is of an app (e.g. `https://puter.com/app/editor`) the `title` tags and meta tags should contain the app's title rather than the generic Puter title.
-
-- The `description` meta tags (`<meta name="description"`, `<meta property="og:description"`, `<meta name="twitter:description"`, ...) should be dynamically set by the server. For example, if the URL is of an app (e.g. `https://puter.com/app/editor`) the `description` meta tags should contain the app's description rather than the generic Puter description.
-
-- Make sure to escape any HTML code that is dynamically added to the HTML page. For example, if the app's description is `Puter is a <b>privacy-first</b> personal cloud to keep all your files, apps, and games in one private and secure place, accessible from anywhere at any time.` the `<b>` tag should be escaped to `&lt;b&gt;` so that the browser doesn't interpret it as an HTML tag.
-
-- Make sure to replace all new line characters with space when dynamically adding text to the HTML page.
-
-- Generally, for UX and SEO reasons make sure that the tags are filled with relevant information about the state the URL is representing. E.g. is the user on the desktop or an app?

doc/self-hosters/domains.md

@@ -1,72 +0,0 @@
-# Configurating Domains for Self-Hosted Puter
-
-## Local Network Configuration
-
-### Prerequisite Conditions
-
-Ensure the hosting device has a static IP address to prevent potential connectivity issues due to IP changes. This setup will enable seamless access to Puter and its services across your local network.
-
-### Using Hosts Files
-
-The hosts file is a straightforward way to map domain names to IP addresses on individual devices. It's simple to set up but requires manual changes on each device that needs access to the domains.
-
-#### Windows
-1. Open Notepad as an administrator.
-2. Open the file located at `C:\Windows\System32\drivers\etc\hosts`.
-3. Add lines for your domain and subdomain with the server's IP address, in the
-   following format:
-   ```
-   192.168.1.10 puter.local
-   192.168.1.10 api.puter.local
-   ```
-
-#### For macOS and Linux:
-1. Open a terminal.
-2. Edit the hosts file with a text editor, e.g., `sudo nano /etc/hosts`.
-3. Add lines for your domain and subdomain with the server's IP address, in the
-   following format:
-   ```
-   192.168.1.10 puter.local
-   192.168.1.10 api.puter.local
-   ```
-4. Save and exit the editor.
-
-
-### Using Router Configuration
-
-Some routers allow you to add custom DNS rules, letting you configure domain names network-wide without touching each device.
-
-1. Access your router’s admin interface (usually through a web browser).
-2. Look for DNS or DHCP settings.
-3. Add custom DNS mappings for `puter.local` and `api.puter.local` to the hosting device's IP address.
-4. Save the changes and reboot the router if necessary.
-
-This method's availability and steps may vary depending on your router's model and firmware.
-
-### Using Local DNS
-
-Setting up a local DNS server on your network allows for flexible and scalable domain name resolution. This method works across all devices automatically once they're configured to use the DNS server.
-
-#### Options for DNS Software:
-
-- **Pi-hole**: Acts as both an ad-blocker and a DNS server. Ideal for easy setup and maintenance.
-- **BIND9**: Offers comprehensive DNS server capabilities for complex setups.
-- **Dnsmasq**: Lightweight and suitable for smaller networks or those new to running a DNS server.
-
-**contributors note:** feel free to add any software you're aware of
-which might help with this to the list. Also, feel free to add instructions here for specific software; our goal is for Puter to be easy to setup with tools you're already familiar with.
-
-#### General Steps:
-
-1. Choose and install DNS server software on a device within your network.
-2. Configure the DNS server to resolve `puter.local` and `api.puter.local` to the IP address of your Puter hosting device.
-3. Update your router’s DHCP settings to distribute the DNS server's IP address to all devices on the network.
-
-By setting up a local DNS server, you gain the most flexibility and control over your network's domain name resolution, ensuring that all devices can access Puter and its API without manual configuration.
-
-## Production Configuration
-
-Please note the self-hosting feature is still in alpha and a public production
-deployment is not recommended at this time. However, if you wish to host
-publically you can do so following the same steps you normally would to configure
-a domain name and ensuring the `api` subdomain points to the server as well.

doc/self-hosters/support.md

@@ -1,39 +0,0 @@
-## Puter Support Levels for Repository Updates
-
-This document describes issues requiring repository changes;
-which issues will be fixed by Puter's core team, and which ones
-will be fixed if the community makes a contribution.
-
-This document is not "law". It is provided only as a helpful guide
-on what to expect.
-
-### Level Glossary
-
-| Name | Description |
-| ---- | ----------- |
-| Core | Core developers will fix this |
-| Community | We will accept contributions to fix this |
-| Mixed | Core developers will fix this if it's currently a priority |
-
-### Issues and their Levels
-
-| Issue | Priority |
-| ----- | -------- |
-| Security vulnerability | Core |
-| Breaking change to SDK or API | Core |
-| Bug in service in CoreModule | Core |
-| Bug in a built-in app | Core |
-| Login/init failure in Docker on `release` branch | Core |
-| Login/init failure in Linux or OSX | Core |
-| Login/init failure in Docker on `main` branch | Mixed |
-| Login/init failure with specific configuration | Mixed |
-| Login/init failure in Windows | Community |
-
-
-## Puter Support for a Particular Deployment
-
-If you experience issues on a self-hosted deployment we're here to
-help. Some issues are related to configuration or environment, so
-we may only be able to help in a limited capacity. Issues related
-to data loss, data corruption, or security will have higher priority
-over other issues with particular deployments.

doc/self-hosting.md

@@ -0,0 +1,433 @@
+# Self-Hosting Puter
+
+`docker-compose.yml` brings up Puter **plus every external service it needs** — MariaDB, Valkey, DynamoDB-local, RustFS S3, nginx — wired together. Closest thing to a production deployment you can self-manage on a single host.
+
+## One-line installer (recommended)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/HeyPuter/puter/main/install.sh | sh
+```
+
+Generates secrets, writes `.env` + `puter/config/config.json`, downloads `docker-compose.yml` from the OSS repo, and runs `docker compose up -d`. Re-running is safe — it won't overwrite existing config (set `PUTER_FORCE=1` to rotate). Use the manual steps below if you want to inspect or tweak each step yourself.
+
+## Requirements
+
+- **Docker** with the `compose` plugin.
+- A **domain** with DNS access — you need a wildcard record (`*.your-domain.com` → server IP). Puter routes by subdomain (`api.<domain>`, `site.<domain>`, `app.<domain>`).
+- Optional: **TLS certs** (or `certbot` to grab them — see Step 3).
+
+## What's running
+
+| Container       | Image                    | Role                                                       |
+| --------------- | ------------------------ | ---------------------------------------------------------- |
+| `puter-nginx`   | `nginx:1.27-alpine`      | Reverse proxy on 80 (and 443 if TLS); forwards to Puter    |
+| `puter`         | `ghcr.io/heyputer/puter` | The app                                                    |
+| `puter-mariadb` | `mariadb:11`             | SQL database — schema applied automatically on first boot  |
+| `puter-valkey`  | `valkey/valkey:8-alpine` | Redis-compatible cache + rate-limiter                      |
+| `puter-dynamo`  | `amazon/dynamodb-local`  | KV store — table auto-created on first boot                |
+| `puter-s3`      | `rustfs/rustfs`          | S3-compatible object storage (MinIO drop-in noted in file) |
+| `puter-s3-init` | `amazon/aws-cli`         | One-shot — creates the bucket on first boot, then exits    |
+
+Optional services (compose profile `ai`, opt-in):
+
+| Container           | Image           | Role                                                           |
+| ------------------- | --------------- | -------------------------------------------------------------- |
+| `puter-ollama`      | `ollama/ollama` | Local LLM provider (CPU; GPU passthrough opt-in)               |
+| `puter-ollama-init` | `ollama/ollama` | One-shot — pulls the default model (`tinyllama`) on first boot |
+
+State lives under `./puter/data/<service>/`.
+
+---
+
+## Step 1 — Create `.env` and `puter/config/config.json`
+
+> ⚠️ **Run this whole block in one shell session.** It generates secrets once and writes them into both `.env` (read by docker compose) and `config.json` (read by Puter). The two files **must** agree on the MariaDB password and the S3 secret — if they drift, MariaDB initialises with one password and Puter tries to log in with another, and you get `ER_ACCESS_DENIED_ERROR`.
+
+```bash
+MARIADB_ROOT_PASSWORD=$(openssl rand -hex 32)
+MARIADB_PASSWORD=$(openssl rand -hex 32)
+S3_SECRET_KEY=$(openssl rand -hex 32)
+JWT_SECRET=$(openssl rand -hex 64)
+JWT_SECRET_V2=$(openssl rand -hex 64)
+URL_SIGNATURE_SECRET=$(openssl rand -hex 64)
+
+cat > .env <<EOF
+HTTP_PORT=80
+# HTTPS_PORT=443     # uncomment after enabling TLS in Step 3
+
+MARIADB_ROOT_PASSWORD=$MARIADB_ROOT_PASSWORD
+MARIADB_DATABASE=puter
+MARIADB_USER=puter
+MARIADB_PASSWORD=$MARIADB_PASSWORD
+
+S3_ACCESS_KEY=puter
+S3_SECRET_KEY=$S3_SECRET_KEY
+S3_BUCKET=puter-local
+EOF
+
+mkdir -p puter/config puter/data puter/tls
+cat > puter/config/config.json <<EOF
+{
+    "domain": "puter.localhost",
+    "protocol": "http",
+    "pub_port": 80,
+    "env": "prod",
+
+    "static_hosting_domain": "site.puter.localhost",
+    "static_hosting_domain_alt": "host.puter.localhost",
+    "private_app_hosting_domain": "app.puter.localhost",
+    "private_app_hosting_domain_alt": "dev.puter.localhost",
+
+    "jwt_secret": "$JWT_SECRET",
+    "jwt_secret_v2": "$JWT_SECRET_V2",
+    "allow_v1_tokens": true,
+    "url_signature_secret": "$URL_SIGNATURE_SECRET",
+
+    "database": {
+        "engine": "mysql",
+        "host": "mariadb",
+        "port": 3306,
+        "user": "puter",
+        "password": "$MARIADB_PASSWORD",
+        "database": "puter",
+        "migrationPaths": ["/opt/puter/dist/src/backend/clients/database/migrations/mysql"]
+    },
+
+    "redis": {
+        "startupNodes": [{ "host": "valkey", "port": 6379 }],
+        "tls": false
+    },
+
+    "dynamo": {
+        "endpoint": "http://dynamo:8000",
+        "bootstrapTables": true,
+        "aws": {
+            "access_key": "fake",
+            "secret_key": "fake",
+            "region": "us-east-1"
+        }
+    },
+
+    "s3": {
+        "s3Config": {
+            "endpoint": "http://s3:9000",
+            "publicEndpoint": "http://s3.puter.localhost",
+            "accessKeyId": "puter",
+            "secretAccessKey": "$S3_SECRET_KEY",
+            "region": "us-east-1",
+            "forcePathStyle": true
+        }
+    },
+    "s3_bucket": "puter-local",
+    "s3_region": "us-east-1",
+
+    "providers": {
+        "ollama": { "enabled": false }
+    },
+
+    "trust_proxy": 1
+}
+EOF
+```
+
+Replace `puter.localhost`, `site.puter.localhost`, `host.puter.localhost`, `dev.puter.localhost` and `app.puter.localhost` with your actual domain (or leave it for a localhost-only trial).
+
+Why these knobs:
+
+- `jwt_secret` + `jwt_secret_v2` — Puter signs new auth tokens with `jwt_secret_v2` (v2 token format, `kid: 'v2'` JWT header). `jwt_secret` is verify-only and lets tokens minted before this version (cookies still in users' browsers, stored API tokens) keep working. `allow_v1_tokens: true` keeps that fallback enabled. Fresh installs can leave it as-is; future versions will flip the flag to `false` and retire `jwt_secret` entirely once legacy tokens have drained.
+- `env: "prod"` — the bundled `config.default.json` ships with `env: "dev"` (matches the source-tree `npm run start=gui` workflow, which expects webpack-dev-server emitting a CSS manifest). Self-host runs against pre-built static bundles, so `env: "prod"` makes the homepage emit the `/dist/bundle.min.css` `<link>` tag instead of waiting on a manifest that doesn't exist.
+- `database.migrationPaths` — Puter applies the bundled MySQL schema on boot. `mysql_mig_1.sql` (tables) and `mysql_mig_2.sql` (default apps: editor, viewer, pdf, camera, player, recorder, git, dev-center, puter-linux). Idempotent — safe to re-run.
+- `dynamo.bootstrapTables: true` — Puter creates its KV table on boot. **Only set against a local emulator**, never real AWS.
+- `dynamo.aws` keys are dummies; DynamoDB-local doesn't validate them but the AWS SDK requires _something_. **Note:** DynamoDB uses `access_key` / `secret_key` (snake_case); S3 below uses `accessKeyId` / `secretAccessKey` (camelCase). Not interchangeable.
+- `providers.ollama.enabled: false` — Puter auto-probes a local Ollama at `127.0.0.1:11434` by default; without one running you'd see `ECONNREFUSED` on every boot. To run a bundled Ollama, see [Optional: local LLM (Ollama)](#optional-local-llm-ollama) below.
+- `s3.s3Config.forcePathStyle: true` — RustFS / MinIO / fauxqs need path-style URLs (`<endpoint>/<bucket>`). Real AWS S3 wants virtual-hosted (`<bucket>.<endpoint>`) — drop this flag (or set `false`) when you swap to real S3.
+- `s3.s3Config.publicEndpoint` — `endpoint` (`http://s3:9000`) only resolves inside the docker network; presigned upload/download URLs handed to the browser need a host-reachable URL. nginx routes the `s3.<domain>` subdomain to RustFS internally and preserves the Host header end-to-end (required for S3 signature validation), so the browser hits the same port/protocol as the rest of the app — no separate published port, no mixed-content surprises when you turn on TLS. Switch to `https://s3.<your-domain>` once you enable TLS in Step 3. Real AWS S3 doesn't need this — its endpoint is already public; drop the field entirely.
+- `trust_proxy: 1` — nginx terminates TLS and forwards `X-Forwarded-For`. Without this, `req.ip` is the docker-network address of the nginx container instead of the real client IP, which breaks rate limiting and IP-based audit logs. `1` = one trusted hop (nginx). Bump to `2` if you put Cloudflare in front of nginx; never set `true` (it trusts every hop and makes XFF forgeable).
+
+> If you ever change `MARIADB_PASSWORD` after first boot, `.env` alone won't update MariaDB — its credentials are baked into `./puter/data/mariadb/` on first init. Either rotate the password inside MariaDB by hand or `docker compose down && rm -rf ./puter/data/mariadb` to start fresh.
+
+## Step 2 — Point DNS at the server \[Optional\]
+
+In your DNS provider, add records for the main domain plus the subdomains Puter and nginx route on (`api.*`, `site.*`, `app.*`, `s3.*`):
+
+```
+A      puter.localhost          → <your server's public IP>
+A      *.puter.localhost        → <your server's public IP>
+A      site.puter.localhost     → <your server's public IP>
+A      *.site.puter.localhost   → <your server's public IP>
+A      host.puter.localhost     → <your server's public IP>
+A      *.host.puter.localhost   → <your server's public IP>
+A      app.puter.localhost      → <your server's public IP>
+A      *.app.puter.localhost    → <your server's public IP>
+A      dev.puter.localhost      → <your server's public IP>
+A      *.dev.puter.localhost    → <your server's public IP>
+```
+
+The wildcards are required — Puter routes via subdomains (`api.*`, `app.*`, etc.) and nginx routes browser S3 traffic via `s3.*` to RustFS.
+
+## Step 3 — TLS (recommended for public installs) \[Optional\]
+
+Skip this for a quick local demo. Don't skip it for users typing passwords.
+
+**Get a wildcard cert.** Easiest path with Let's Encrypt + DNS-01 (works for wildcards):
+
+```bash
+sudo certbot certonly --manual --preferred-challenges dns \
+    -d puter.localhost -d "*.puter.localhost" \
+    -d site.puter.localhost -d "*.site.puter.localhost" \
+    -d host.puter.localhost -d "*.host.puter.localhost" \
+    -d app.puter.localhost -d "*.app.puter.localhost" \
+    -d dev.puter.localhost -d "*.dev.puter.localhost"
+```
+
+The cert needs to cover `*.puter.localhost` so that `s3.puter.localhost` (browser S3 endpoint), plus Puter's own `api.*` / `app.*` subdomains, all validate.
+
+Drop the resulting `fullchain.pem` and `privkey.pem` into `./puter/tls/`.
+
+**Wire nginx to use them:**
+
+1. Open [nginx/nginx.conf](../nginx/nginx.conf), uncomment **both** `# server { listen 443 ssl … }` blocks (one for `s3.*`, one for the catch-all).
+2. (Optional) Replace the body of the port-80 blocks with `return 301 https://$host$request_uri;` to force HTTPS everywhere.
+3. In [docker-compose.yml](../docker-compose.yml), uncomment the `443:443` port mapping under the `nginx` service.
+4. In `.env`, uncomment `HTTPS_PORT=443`.
+5. In `config.json`, switch:
+    ```json
+    { "protocol": "https", "pub_port": 443 }
+    ```
+    …and update the S3 public endpoint:
+    ```json
+    "s3": { "s3Config": { "publicEndpoint": "https://s3.puter.local", ... } }
+    ```
+
+## Step 4 — Bring it up
+
+```bash
+docker compose up -d
+```
+
+First boot takes ~30s while MariaDB initialises and Puter applies the schema + default apps. Watch:
+
+```bash
+docker compose logs -f puter
+```
+
+Healthy startup:
+
+```
+[config] override from /etc/puter/config.json
+[mysql] running migrations from /opt/puter/dist/src/backend/clients/database/migrations/mysql: 2 file(s)
+[mysql] applied mysql_mig_1.sql (...)
+[mysql] applied mysql_mig_2.sql (9 statements)
+```
+
+Then open **<https://puter.local>** (or `http://` if you skipped TLS). Login is `admin` — the temp password is printed once in the puter container logs on first boot:
+
+```bash
+docker compose logs puter | grep tmp_password
+```
+
+Change it in Settings after first login.
+
+## Additional configuration
+
+All optional. Drop any of the blocks below into `puter/config/config.json` and `docker compose restart puter`. See [config.template.jsonc](../config.template.jsonc) for the full list. Per-key documentation lives in [src/backend/types.ts](../src/backend/types.ts).
+
+### Email (SMTP)
+
+Used for password resets, email confirmation, and notifications. Without it those flows silently fail.
+
+```json
+"email": {
+    "from": "\"Puter\" <[email protected]>",
+    "host": "smtp.example.com",
+    "port": 587,
+    "secure": false,
+    "auth": { "user": "...", "pass": "..." }
+}
+```
+
+To require email confirmation before login, also set `"strict_email_verification_required": true`.
+
+### Sign in with Google (or another OIDC provider)
+
+```json
+"oidc": {
+    "providers": {
+        "google": {
+            "client_id": "...apps.googleusercontent.com",
+            "client_secret": "...",
+            "scopes": "openid email profile"
+        }
+    }
+}
+```
+
+Add `https://puter.<your-domain>/auth/oidc/callback/login` to the OAuth client's authorized redirect URIs in the Google Cloud Console. For non-Google providers, replace `google` with a custom id and supply `authorization_endpoint` / `token_endpoint` / `userinfo_endpoint` explicitly.
+
+### Sign in with Apple
+
+```json
+"oidc": {
+    "providers": {
+        "apple": {
+            "client_id": "com.example.your-service-id",
+            "team_id": "YOUR_TEAM_ID",
+            "key_id": "YOUR_KEY_ID",
+            "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
+        }
+    }
+}
+```
+
+The `client_id` is your Apple Services ID. `team_id`, `key_id`, and `private_key` come from the Apple Developer Portal (Keys section — create a key with "Sign in with Apple" enabled). The `private_key` is the contents of the `.p8` file Apple provides. Add `https://puter.<your-domain>/auth/oidc/callback/login` and `https://puter.<your-domain>/auth/oidc/callback/signup` as return URLs in the Apple Services ID configuration.
+
+### Sign in with Microsoft
+
+```json
+"oidc": {
+    "providers": {
+        "microsoft": {
+            "client_id": "YOUR_APPLICATION_CLIENT_ID",
+            "client_secret": "YOUR_CLIENT_SECRET_VALUE",
+            "tenant_id": "YOUR_TENANT_ID"
+        }
+    }
+}
+```
+
+Register an app in the Azure Portal (Microsoft Entra ID → App registrations). The `client_id` is the Application (client) ID, `client_secret` is a client secret value, and `tenant_id` is the Directory (tenant) ID. Use `common` as `tenant_id` to allow any Microsoft account (personal and organizational); omit it to default to `common`. Add `https://puter.<your-domain>/auth/oidc/callback/login` and `https://puter.<your-domain>/auth/oidc/callback/signup` as redirect URIs under Authentication in the app registration.
+
+### AI providers
+
+Any provider with a key set is auto-enabled. Same shape as `ollama` above:
+
+```json
+"providers": {
+    "claude":            { "apiKey": "sk-ant-..." },
+    "openai-completion": { "apiKey": "sk-..." },
+    "gemini":            { "apiKey": "..." },
+    "openai-image-generation": { "apiKey": "sk-..." }
+}
+```
+
+Full provider list (chat, image, video, TTS, OCR) is in the template.
+
+### Per-user storage quota
+
+Default is 100 MB per user.
+
+```json
+"storage_capacity": 5368709120,   // 5 GB
+"is_storage_limited": true
+```
+
+Set `is_storage_limited: false` for unlimited (bounded by host disk).
+
+### Captcha on signup / login
+
+Built-in proof-of-work captcha — no external service needed.
+
+```json
+"captcha": { "enabled": true, "difficulty": "medium" }
+```
+
+`difficulty` is one of `easy` / `medium` / `hard`.
+
+### Block disposable email TLDs
+
+Only enforced when `env: "prod"`.
+
+```json
+"blockedEmailDomains": ["mailinator.com", "tempmail.com", "guerrillamail.com"]
+```
+
+### Password policy
+
+```json
+"min_pass_length": 12
+```
+
+### Contact-form recipient
+
+Where the in-app contact form posts. Defaults to `support@puter.com`.
+
+```json
+"support_email": "[email protected]"
+```
+
+## Optional: local LLM (Ollama)
+
+The `ollama` and `ollama-init` services live behind a compose profile so they don't run unless you ask for them. By default, `puter/config/config.json` has `"ollama": { "enabled": false }` — Puter skips the auto-probe entirely. To run a local model:
+
+1. Flip the config:
+    ```json
+    "providers": {
+        "ollama": { "apiBaseUrl": "http://ollama:11434" }
+    }
+    ```
+2. (Optional) Pick a model in `.env`:
+    ```bash
+    OLLAMA_DEFAULT_MODEL=tinyllama   # default — 1.1B, ~640 MB on disk, ~700 MB RAM
+    # Other tiny picks: qwen2.5:0.5b, llama3.2:1b
+    # Larger / better: phi3.5, llama3.2, mistral
+    ```
+3. Bring up with the `ai` profile:
+    ```bash
+    docker compose --profile ai up -d
+    docker compose logs -f ollama-init
+    ```
+    `ollama-init` exits 0 once the model is pulled. Subsequent boots find the model already on disk and the pull is a fast no-op.
+
+Without `--profile ai`, the `ollama` containers stay down and Puter (with `enabled: false`) doesn't try to reach them — the rest of the stack runs identically.
+
+For GPU acceleration (NVIDIA), uncomment the `deploy:` block under the `ollama` service in [docker-compose.yml](../docker-compose.yml). Requires `nvidia-container-toolkit` on the host.
+
+## Building from source instead of pulling
+
+If you want to test local Dockerfile changes against the full stack, uncomment the `build:` block in [docker-compose.yml](../docker-compose.yml) under the `puter` service, change `pull_policy: always` → `pull_policy: never`, then:
+
+```bash
+docker compose up -d --build
+```
+
+---
+
+## Managing running backend
+
+```bash
+# update
+docker compose pull
+docker compose up -d
+
+# logs
+docker compose logs -f puter
+
+# stop, keep data
+docker compose down
+
+# stop, NUKE all state (irreversible)
+docker compose down
+rm -rf puter/data
+```
+
+Migrations re-apply idempotently across pulls. Volumes are preserved.
+
+## Troubleshooting
+
+**Site loads but I get "Bad Gateway" / nginx errors.**
+The puter container failed to come up. `docker compose logs puter` will tell you which dependency rejected it (most often DB password mismatch between `.env` and `config.json`).
+
+**Login screen says "admin password not set".**
+First-boot temp password is logged once. Find it: `docker compose logs puter | grep "tmp_password"`. After login, change it in Settings.
+
+**Healthcheck reports unhealthy but the site works.**
+The healthcheck hits `puter.localhost:4100/test` from inside the container. If you changed `domain` or `port`, the check still uses defaults. The site itself is fine.
+
+**Nothing resolves at `puter.example.com` after DNS changes.**
+DNS propagates slowly. `dig puter.example.com` and `dig api.puter.example.com` should both return your server IP. If not, give it 5–60 minutes.
+
+**`docker compose up` hangs at "waiting for service to be healthy".**
+`docker compose ps` shows which container is unhealthy. MariaDB takes ~20–30s on a cold boot; everything else under 5s. If something stays unhealthy, `logs <service>` will tell you why.
+
+**`Error: DynamoDB aws config requires both access_key and secret_key`.**
+You wrote `accessKeyId` / `secretAccessKey` under `dynamo.aws`. That config block uses snake_case (`access_key` / `secret_key`). Only the `s3.s3Config` block uses camelCase.

docker-compose.yml

@@ -1,25 +1,293 @@
 ---
-version: "3.8"
+# Self-hosted Puter — full stack.
+#
+# Brings up Puter + every external service it needs:
+#   - nginx    : reverse proxy (mirrors prod ALB; handles TLS + Host fan-out)
+#   - valkey   : redis-compatible cache / rate-limiter backend
+#   - mariadb  : SQL database (Puter applies its schema on first boot)
+#   - dynamo   : DynamoDB-local (KV store; Puter creates the table itself)
+#   - s3       : RustFS — S3-compatible object storage
+#   - s3-init  : one-shot init container that creates the bucket
+#   - puter    : the application
+#
+# Quick start:
+#   1. Copy .env.example to .env (or set the variables in your shell).
+#   2. Drop a config.json into ./puter/config/ — see selfhosted/full-stack.md
+#      for the example that pairs with this compose.
+#   3. docker compose up -d
+#
+# Easiest path:
+#   curl -fsSL https://raw.githubusercontent.com/HeyPuter/puter/main/install.sh | sh
+# grabs this file, generates secrets, writes .env + config.json, and runs
+# the compose up for you.
+#
+# Production:
+#   - Always replace the default passwords / S3 keys / Puter secrets.
+#   - Front Puter with TLS-terminating reverse proxy (Caddy / nginx).
+#   - Move state-bearing volumes to a backed-up location.
+
 services:
-  puter:
-    container_name: puter
-    image: ghcr.io/heyputer/puter:latest
-    pull_policy: always
-    # build: ./
+  valkey:
+    image: valkey/valkey:8-alpine
+    container_name: puter-valkey
+    restart: unless-stopped
+    # Run as a single-node cluster so Puter's ioredis Cluster client
+    # (the only mode it speaks) can connect. On first boot we assign all
+    # 16384 slots to ourselves; subsequent boots find them already in
+    # nodes.conf and skip. `cluster-require-full-coverage no` keeps reads
+    # working if we ever land partial slots.
+    command:
+      - sh
+      - -c
+      - |
+        valkey-server \
+          --port 6379 \
+          --cluster-enabled yes \
+          --cluster-config-file /data/nodes.conf \
+          --cluster-node-timeout 5000 \
+          --cluster-require-full-coverage no \
+          --cluster-announce-ip valkey \
+          --cluster-announce-port 6379 \
+          --cluster-announce-bus-port 16379 \
+          --appendonly yes \
+          --save "60 1" &
+        SERVER_PID=$$!
+        until valkey-cli -p 6379 PING > /dev/null 2>&1; do sleep 0.5; done
+        if ! valkey-cli -p 6379 CLUSTER NODES | grep -q '0-16383'; then
+          valkey-cli -p 6379 CLUSTER ADDSLOTSRANGE 0 16383
+        fi
+        wait $$SERVER_PID
+    volumes:
+      # `:z` is an SELinux relabel hint for Fedora/RHEL hosts (no-op
+      # everywhere else) — without it those distros deny container
+      # access to the bind mount and the service loops on EACCES.
+      - ./puter/data/valkey:/data:z
+    healthcheck:
+      test:
+        ["CMD-SHELL", "valkey-cli -p 6379 cluster info | grep -q cluster_state:ok"]
+      interval: 5s
+      timeout: 3s
+      retries: 20
+      start_period: 10s
+
+  mariadb:
+    image: mariadb:11
+    container_name: puter-mariadb
     restart: unless-stopped
-    ports:
-      - '4100:4100'
     environment:
-      # TZ: Europe/Paris
-      # CONFIG_PATH: /etc/puter
+      MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD:-root-change-me}
+      MARIADB_DATABASE: ${MARIADB_DATABASE:-puter}
+      MARIADB_USER: ${MARIADB_USER:-puter}
+      MARIADB_PASSWORD: ${MARIADB_PASSWORD:-puter-change-me}
+    volumes:
+      - ./puter/data/mariadb:/var/lib/mysql:z
+    healthcheck:
+      # `healthcheck.sh` ships with the mariadb image; --connect verifies
+      # the server is accepting auth, not just listening on the socket.
+      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
+      interval: 5s
+      timeout: 5s
+      retries: 20
+      start_period: 30s
+
+  dynamo:
+    # Puter creates the `store-kv-v1` table itself on startup
+    # (config.dynamo.bootstrapTables = true does the work).
+    image: amazon/dynamodb-local:latest
+    container_name: puter-dynamo
+    restart: unless-stopped
+    user: "1000:1000"
+    working_dir: /home/dynamodblocal
+    command:
+      - "-jar"
+      - "DynamoDBLocal.jar"
+      - "-sharedDb"
+      - "-dbPath"
+      - "/home/dynamodblocal/data"
+    volumes:
+      - ./puter/data/dynamo:/home/dynamodblocal/data:z
+
+  s3:
+    # RustFS — S3-compatible object storage. Drop-in alternative:
+    # MinIO (image: minio/minio, command: ["server", "/data", "--console-address", ":9001"]).
+    image: rustfs/rustfs:latest
+    container_name: puter-s3
+    restart: unless-stopped
+    environment:
+      RUSTFS_ACCESS_KEY: ${S3_ACCESS_KEY:-puter}
+      RUSTFS_SECRET_KEY: ${S3_SECRET_KEY:-puter-secret-change-me}
+    volumes:
+      - ./puter/data/s3:/data:z
+    # Internal-only — browsers reach RustFS via nginx (`s3.<domain>`),
+    # which preserves the Host header for S3 signature validation and
+    # rides the same TLS termination as Puter. Uncomment to also expose
+    # 9000 directly on the host for `aws-cli` / debugging.
+    # ports:
+    #   - "9000:9000"
+    healthcheck:
+      # RustFS exposes /health on the S3 port. Use wget (curl is not in
+      # the slim image).
+      test:
+        [
+          "CMD-SHELL",
+          "wget -qO- --tries=1 --timeout=2 http://localhost:9000/health || exit 1",
+        ]
+      interval: 5s
+      timeout: 3s
+      retries: 20
+      start_period: 5s
+
+  s3-init:
+    # One-shot container that creates the `puter-local` bucket on first
+    # boot. Exits 0 once the bucket exists; stays exited 0 thereafter.
+    image: amazon/aws-cli:latest
+    container_name: puter-s3-init
+    depends_on:
+      s3:
+        condition: service_healthy
+    environment:
+      AWS_ACCESS_KEY_ID: ${S3_ACCESS_KEY:-puter}
+      AWS_SECRET_ACCESS_KEY: ${S3_SECRET_KEY:-puter-secret-change-me}
+      AWS_DEFAULT_REGION: us-east-1
+    entrypoint:
+      - /bin/sh
+      - -c
+      - |
+        set -e
+        endpoint=http://s3:9000
+        bucket=${S3_BUCKET:-puter-local}
+        if aws --endpoint-url "$$endpoint" s3api head-bucket --bucket "$$bucket" 2>/dev/null; then
+          echo "bucket $$bucket already exists"
+        else
+          echo "creating bucket $$bucket"
+          aws --endpoint-url "$$endpoint" s3 mb "s3://$$bucket"
+        fi
+    restart: "no"
+
+  # ── Optional: local LLM ───────────────────────────────────────────
+  # Behind the `ai` compose profile — only starts when explicitly opted
+  # into. Bring up with:
+  #   docker compose --profile ai up -d
+  # When enabled, also set in your `puter/config/config.json`:
+  #   "providers": { "ollama": { "apiBaseUrl": "http://ollama:11434" } }
+  # When NOT enabled, set:
+  #   "providers": { "ollama": { "enabled": false } }
+  # otherwise Puter spams `ECONNREFUSED 127.0.0.1:11434` on startup.
+  ollama:
+    profiles: ["ai"]
+    # CPU-only out of the box; uncomment the GPU `deploy:` block below
+    # if you've got nvidia-docker for much faster inference. Disk + RAM
+    # scale with the model — `tinyllama` (1.1B, ~640 MB on disk, ~700
+    # MB RAM) is the cheapest sane default. Swap via OLLAMA_DEFAULT_MODEL.
+    image: ollama/ollama:latest
+    container_name: puter-ollama
+    restart: unless-stopped
+    volumes:
+      - ./puter/data/ollama:/root/.ollama:z
+    # Uncomment to expose Ollama directly on the host (`localhost:11434`)
+    # for `ollama` CLI / OpenAI-API compatible tools. Internal-only by default.
+    # ports:
+    #   - "11434:11434"
+    healthcheck:
+      test:
+        ["CMD-SHELL", "ollama list >/dev/null 2>&1 || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 15s
+    # GPU passthrough (NVIDIA). Requires nvidia-container-toolkit on host.
+    # deploy:
+    #   resources:
+    #     reservations:
+    #       devices:
+    #         - driver: nvidia
+    #           count: all
+    #           capabilities: [gpu]
+
+  ollama-init:
+    profiles: ["ai"]
+    # One-shot — ensures the default model is present. `ollama pull` is
+    # idempotent: present-and-up-to-date → fast no-op; missing → downloads.
+    image: ollama/ollama:latest
+    container_name: puter-ollama-init
+    depends_on:
+      ollama:
+        condition: service_healthy
+    environment:
+      OLLAMA_HOST: http://ollama:11434
+      OLLAMA_DEFAULT_MODEL: ${OLLAMA_DEFAULT_MODEL:-tinyllama}
+    entrypoint:
+      - /bin/sh
+      - -c
+      - |
+        set -e
+        echo "[ollama-init] ensuring $${OLLAMA_DEFAULT_MODEL}"
+        ollama pull "$${OLLAMA_DEFAULT_MODEL}"
+        echo "[ollama-init] done"
+    restart: "no"
+
+  puter:
+    image: ghcr.io/heyputer/puter:main
+    pull_policy: always
+    # Uncomment to build from this directory instead of pulling the published
+    # image. Also flip pull_policy to `never` so compose doesn't overwrite
+    # your local build by re-pulling :latest.
+    # build:
+    #   context: .
+    #   # buildx-only: cross-compile to both archs in a single push
+    #   # platforms:
+    #   #   - linux/amd64
+    #   #   - linux/arm64
+    container_name: puter
+    restart: unless-stopped
+    depends_on:
+      valkey:
+        condition: service_healthy
+      mariadb:
+        condition: service_healthy
+      dynamo:
+        condition: service_started
+      s3-init:
+        condition: service_completed_successfully
+    # Internal-only: nginx reaches it on the compose network. Uncomment
+    # to also expose port 4100 directly on the host (useful for debugging).
+    # ports:
+    #   - "4100:4100"
+    expose:
+      - "4100"
+    environment:
       PUID: 1000
       PGID: 1000
     volumes:
-      - ./puter/config:/etc/puter
-      - ./puter/data:/var/puter
+      # Drop your config.json here — see selfhosted/full-stack.md.
+      - ./puter/config:/etc/puter:z
+      # Persistent runtime data (anything your config points at /var/puter).
+      - ./puter/data/puter:/var/puter:z
     healthcheck:
       test: wget --no-verbose --tries=1 --spider http://puter.localhost:4100/test || exit 1
       interval: 30s
       timeout: 3s
       retries: 3
       start_period: 30s
+
+  nginx:
+    image: nginx:1.27-alpine
+    container_name: puter-nginx
+    restart: unless-stopped
+    depends_on:
+      puter:
+        condition: service_started
+    ports:
+      - "${HTTP_PORT:-80}:80"
+      # Uncomment when you enable TLS in nginx/nginx.conf:
+      # - "${HTTPS_PORT:-443}:443"
+    volumes:
+      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro,z
+      # TLS certs (fullchain.pem + privkey.pem). Read-only inside.
+      - ./puter/tls:/etc/nginx/tls:ro,z
+    healthcheck:
+      test: ["CMD-SHELL", "wget -qO- --tries=1 --timeout=2 http://localhost/ || exit 1"]
+      interval: 10s
+      timeout: 3s
+      retries: 5
+      start_period: 5s

eslint.config.js

@@ -0,0 +1,130 @@
+import js from '@eslint/js';
+import tseslintPlugin from '@typescript-eslint/eslint-plugin';
+import tseslintParser from '@typescript-eslint/parser';
+import prettierPlugin from 'eslint-plugin-prettier';
+import prettierConfig from 'eslint-config-prettier';
+import { defineConfig } from 'eslint/config';
+import globals from 'globals';
+
+// typescript-eslint's flat/recommended preset is an array of configs (base +
+// eslint-recommended overrides + recommended rules). Flatten its rules so we
+// can apply them via our own `files`-scoped blocks.
+const tsRecommendedRules = tseslintPlugin.configs['flat/recommended'].reduce(
+    (acc, cfg) => ({ ...acc, ...(cfg.rules ?? {}) }),
+    {},
+);
+
+const prettierRules = {
+    ...prettierConfig.rules,
+    'prettier/prettier': 'error',
+};
+
+const unusedVarsOptions = {
+    args: 'after-used',
+    argsIgnorePattern: '^_',
+    varsIgnorePattern: '^_',
+    caughtErrorsIgnorePattern: '^_',
+    destructuredArrayIgnorePattern: '^_',
+    ignoreRestSiblings: true,
+};
+
+const preferConstOptions = {
+    destructuring: 'all',
+    ignoreReadBeforeAssign: false,
+};
+
+const lintedGlobals = {
+    ...globals.node,
+    extension: 'readonly',
+    config: 'readonly',
+    global_config: 'readonly',
+};
+
+const jsFiles = [
+    'src/backend/**/*.{js,mjs,cjs}',
+    'extensions/**/*.{js,mjs,cjs}',
+];
+
+const tsIgnores = [
+    '**/*.test.ts',
+    '**/*.test.mts',
+    '**/*.spec.ts',
+    '**/*.spec.mts',
+    'src/backend/test/**',
+    'src/backend/tools/**',
+    'src/backend/vitest.config.ts',
+    'src/backend/vitest.bench.config.ts',
+];
+
+const createTsConfig = ({ files, project }) => ({
+    files,
+    ignores: tsIgnores,
+    languageOptions: {
+        parser: tseslintParser,
+        globals: lintedGlobals,
+        parserOptions: {
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+            projectService: { defaultProject: project },
+            tsconfigRootDir: import.meta.dirname,
+        },
+    },
+    plugins: {
+        '@typescript-eslint': tseslintPlugin,
+        prettier: prettierPlugin,
+    },
+    rules: {
+        ...tsRecommendedRules,
+        ...prettierRules,
+        '@typescript-eslint/no-unused-vars': ['error', unusedVarsOptions],
+        '@typescript-eslint/no-explicit-any': 'warn',
+        'prefer-const': ['error', preferConstOptions],
+    },
+});
+
+export default defineConfig([
+    {
+        ignores: [
+            '**/*.dbmig.js',
+            'dist/**',
+            'build/**',
+            'volatile/**',
+            'node_modules/**',
+            'puter.js/**',
+            'apps/**',
+            'experiment/**',
+            'workers/**',
+            'src/public/**',
+            'src/gui/**',
+            'src/docs/**',
+            'src/puter-js/**',
+            'src/worker/**',
+            'submodules/**',
+            'tests/**',
+            'tools/**',
+        ],
+    },
+    {
+        files: jsFiles,
+        ignores: ['**/*.test.js'],
+        plugins: {
+            js,
+            prettier: prettierPlugin,
+        },
+        extends: ['js/recommended'],
+        languageOptions: {
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+            globals: lintedGlobals,
+        },
+        rules: {
+            ...prettierRules,
+            'no-unused-vars': ['error', unusedVarsOptions],
+            'prefer-const': ['error', preferConstOptions],
+        },
+    },
+    createTsConfig({
+        files: ['src/backend/**/*.ts', 'extensions/**/*.ts'],
+        project: './tsconfig.json',
+    }),
+]);

exports.js

@@ -1,2 +0,0 @@
-import backend from '@heyputer/backend';
-export default backend;

extensions/appTelemetry.test.ts

@@ -0,0 +1,221 @@
+import type { Request, Response } from 'express';
+import { v4 as uuidv4 } from 'uuid';
+import {
+    afterAll,
+    beforeAll,
+    describe,
+    expect,
+    it,
+    vi,
+} from 'vitest';
+import { runWithContext } from '../src/backend/core/context.ts';
+import { PuterServer } from '../src/backend/server.ts';
+import { setupTestServer } from '../src/backend/testUtil.ts';
+import {
+    handleAppTelemetryUserCount,
+    handleAppTelemetryUsers,
+} from './appTelemetry.ts';
+
+interface CapturedResponse {
+    body: unknown;
+}
+
+const makeReq = (query: Record<string, unknown> = {}): Request =>
+    ({ query }) as unknown as Request;
+
+const makeRes = () => {
+    const captured: CapturedResponse = { body: undefined };
+    const res = {
+        json: vi.fn((value: unknown) => {
+            captured.body = value;
+            return res;
+        }),
+        status: vi.fn(() => res),
+    };
+    return { res: res as unknown as Response, captured };
+};
+
+// `handleAppTelemetryUsers` calls `Context.get('actor')` for the permission
+// gate. Wrap test calls in `runWithContext` so the ALS lookup resolves.
+const callWithActor = async (
+    actor: { user: { uuid: string; id?: number }; app?: null } | undefined,
+    fn: () => Promise<void>,
+) => runWithContext({ actor }, fn);
+
+let server: PuterServer;
+
+beforeAll(async () => {
+    server = await setupTestServer();
+});
+
+afterAll(async () => {
+    await server.shutdown();
+});
+
+describe('appTelemetry extension — handleAppTelemetryUsers', () => {
+    it('throws HttpError(400) when app_uuid is missing', async () => {
+        const { res } = makeRes();
+        await expect(
+            handleAppTelemetryUsers(makeReq({}), res),
+        ).rejects.toMatchObject({
+            statusCode: 400,
+            message: expect.stringContaining('app_uuid'),
+        });
+    });
+
+    it('throws HttpError(400) for a non-numeric limit', async () => {
+        const { res } = makeRes();
+        await expect(
+            handleAppTelemetryUsers(
+                makeReq({ app_uuid: 'app-anything', limit: 'banana' }),
+                res,
+            ),
+        ).rejects.toMatchObject({
+            statusCode: 400,
+            message: expect.stringContaining('limit'),
+        });
+    });
+
+    it('throws HttpError(400) when offset exceeds the allowed maximum', async () => {
+        const { res } = makeRes();
+        await expect(
+            handleAppTelemetryUsers(
+                makeReq({ app_uuid: 'app-anything', offset: 1_000_001 }),
+                res,
+            ),
+        ).rejects.toMatchObject({ statusCode: 400 });
+    });
+
+    it('throws HttpError(404) when the app cannot be found', async () => {
+        const { res } = makeRes();
+        await expect(
+            handleAppTelemetryUsers(
+                makeReq({ app_uuid: 'app-does-not-exist' }),
+                res,
+            ),
+        ).rejects.toMatchObject({
+            statusCode: 404,
+            message: 'App not found',
+        });
+    });
+
+    it('throws HttpError(403) when the caller does not own the app', async () => {
+        // Seed an owner user + an app belonging to them, then call the
+        // handler as a *different* user. The real permission service should
+        // reject since the caller has no `apps-of-user:<owner>:write` perm.
+        const owner = await server.stores.user.create({
+            username: `owner_${Math.random().toString(36).slice(2, 8)}`,
+            uuid: uuidv4(),
+            password: 'x',
+            email: null,
+        });
+        const slug = Math.random().toString(36).slice(2, 8);
+        const app = await server.stores.app.create(
+            {
+                name: `app_${slug}`,
+                title: `App ${slug}`,
+                index_url: `https://example.com/${slug}`,
+            },
+            { ownerUserId: owner.id as number },
+        );
+
+        const intruder = await server.stores.user.create({
+            username: `intruder_${Math.random().toString(36).slice(2, 8)}`,
+            uuid: uuidv4(),
+            password: 'x',
+            email: null,
+        });
+
+        const { res } = makeRes();
+        await callWithActor(
+            { user: { uuid: intruder.uuid, id: intruder.id as number } },
+            async () => {
+                await expect(
+                    handleAppTelemetryUsers(
+                        makeReq({ app_uuid: app!.uid }),
+                        res,
+                    ),
+                ).rejects.toMatchObject({
+                    statusCode: 403,
+                    message: 'Permission denied',
+                });
+            },
+        );
+    });
+
+    it('returns an empty list for an owned app with no authenticated users', async () => {
+        const owner = await server.stores.user.create({
+            username: `owner2_${Math.random().toString(36).slice(2, 8)}`,
+            uuid: uuidv4(),
+            password: 'x',
+            email: null,
+        });
+        const slug = Math.random().toString(36).slice(2, 8);
+        const app = await server.stores.app.create(
+            {
+                name: `app2_${slug}`,
+                title: `App2 ${slug}`,
+                index_url: `https://example.com/${slug}`,
+            },
+            { ownerUserId: owner.id as number },
+        );
+
+        const { res, captured } = makeRes();
+        await callWithActor(
+            { user: { uuid: owner.uuid, id: owner.id as number } },
+            async () => {
+                await handleAppTelemetryUsers(
+                    makeReq({ app_uuid: app!.uid }),
+                    res,
+                );
+            },
+        );
+
+        expect(captured.body).toEqual([]);
+    });
+});
+
+describe('appTelemetry extension — handleAppTelemetryUserCount', () => {
+    it('throws HttpError(400) when app_uuid is missing', async () => {
+        const { res } = makeRes();
+        await expect(
+            handleAppTelemetryUserCount(makeReq({}), res),
+        ).rejects.toMatchObject({ statusCode: 400 });
+    });
+
+    it('throws HttpError(404) for an unknown app_uuid', async () => {
+        const { res } = makeRes();
+        await expect(
+            handleAppTelemetryUserCount(
+                makeReq({ app_uuid: 'app-not-here' }),
+                res,
+            ),
+        ).rejects.toMatchObject({ statusCode: 404 });
+    });
+
+    it('returns { count: 0 } for an app with no authenticated users', async () => {
+        const owner = await server.stores.user.create({
+            username: `counto_${Math.random().toString(36).slice(2, 8)}`,
+            uuid: uuidv4(),
+            password: 'x',
+            email: null,
+        });
+        const slug = Math.random().toString(36).slice(2, 8);
+        const app = await server.stores.app.create(
+            {
+                name: `appcount_${slug}`,
+                title: `AppCount ${slug}`,
+                index_url: `https://example.com/${slug}`,
+            },
+            { ownerUserId: owner.id as number },
+        );
+
+        const { res, captured } = makeRes();
+        await handleAppTelemetryUserCount(
+            makeReq({ app_uuid: app!.uid }),
+            res,
+        );
+
+        expect(captured.body).toEqual({ count: 0 });
+    });
+});

extensions/appTelemetry.ts

@@ -0,0 +1,131 @@
+import type { Request, Response } from 'express';
+import { Context } from '@heyputer/backend/src/core';
+import { HttpError } from '@heyputer/backend/src/core/http';
+import { extension } from '@heyputer/backend/src/extensions';
+
+const clients = extension.import('client');
+const stores = extension.import('store');
+const services = extension.import('service');
+
+const DEFAULT_LIMIT = 100;
+const MAX_LIMIT = 1000;
+const MAX_OFFSET = 100_000;
+
+const parseIntParam = (
+    value: unknown,
+    {
+        key,
+        min,
+        max,
+        fallback,
+    }: { key: string; min: number; max: number; fallback: number },
+): number => {
+    if (value === undefined || value === null) return fallback;
+    const parsed =
+        typeof value === 'number'
+            ? value
+            : typeof value === 'string' && value.trim() !== ''
+              ? Number(value)
+              : NaN;
+    if (
+        !Number.isFinite(parsed) ||
+        !Number.isInteger(parsed) ||
+        parsed < min ||
+        parsed > max
+    ) {
+        throw new HttpError(
+            400,
+            `${key} must be an integer between ${min} and ${max}`,
+        );
+    }
+    return parsed;
+};
+
+export const handleAppTelemetryUsers = async (
+    req: Request,
+    res: Response,
+): Promise<void> => {
+    const { app_uuid } = req.query as Record<string, string>;
+    if (!app_uuid) throw new HttpError(400, 'Missing `app_uuid`');
+
+    const safeLimit = parseIntParam(req.query.limit, {
+        key: 'limit',
+        min: 1,
+        max: MAX_LIMIT,
+        fallback: DEFAULT_LIMIT,
+    });
+    const safeOffset = parseIntParam(req.query.offset, {
+        key: 'offset',
+        min: 0,
+        max: MAX_OFFSET,
+        fallback: 0,
+    });
+
+    const app = await stores.app.getByUid(app_uuid);
+    if (!app) throw new HttpError(404, 'App not found');
+
+    // `apps-of-user:<uuid>:write` — the implicator keys on the owner's
+    // UUID, not the numeric id. Look up the owner explicitly. v1 got
+    // this for free because its entity-storage layer eager-joined the
+    // owner row; v2's AppStore.getByUid returns the raw row with only
+    // `owner_user_id` populated.
+    const ownerId = (app as { owner_user_id?: number }).owner_user_id;
+    if (!ownerId) throw new HttpError(404, 'App owner not found');
+    const owner = (await stores.user.getById(ownerId)) as {
+        uuid?: string;
+    } | null;
+    if (!owner?.uuid) throw new HttpError(404, 'App owner not found');
+
+    const actor = Context.get('actor');
+    const ownsApp = await services.permission
+        .check(actor!, `apps-of-user:${owner.uuid}:write`)
+        .catch(() => false);
+    if (!ownsApp) throw new HttpError(403, 'Permission denied');
+
+    const users = await clients.db.read(
+        `SELECT u.username, u.uuid FROM user_to_app_permissions p
+         INNER JOIN user u ON p.user_id = u.id
+         WHERE p.permission = 'flag:app-is-authenticated' AND p.app_id = ?
+         ORDER BY (p.dt IS NOT NULL), p.dt, p.user_id
+         LIMIT ? OFFSET ?`,
+        [(app as Record<string, unknown>).id, safeLimit, safeOffset],
+    );
+
+    res.json(
+        (users as Array<{ username: string; uuid: string }>).map((e) => ({
+            user: e.username,
+            user_uuid: e.uuid,
+        })),
+    );
+};
+
+export const handleAppTelemetryUserCount = async (
+    req: Request,
+    res: Response,
+): Promise<void> => {
+    const { app_uuid } = req.query as Record<string, string>;
+    if (!app_uuid) throw new HttpError(400, 'Missing `app_uuid`');
+
+    const app = await stores.app.getByUid(app_uuid);
+    if (!app) throw new HttpError(404, 'App not found');
+
+    const [row] = (await clients.db.read(
+        `SELECT COUNT(*) AS n FROM user_to_app_permissions
+         WHERE permission = 'flag:app-is-authenticated' AND app_id = ?`,
+        [(app as Record<string, unknown>).id],
+    )) as Array<{ n: number }>;
+
+    res.json({ count: row?.n ?? 0 });
+};
+
+extension.get(
+    '/app-telemetry/users',
+    { subdomain: 'api', requireAuth: true },
+    handleAppTelemetryUsers,
+);
+
+extension.get(
+    '/app-telemetry/user-count',
+    { subdomain: 'api', requireAuth: true },
+    handleAppTelemetryUserCount,
+);

extensions/devWatcher.ts

@@ -0,0 +1,421 @@
+import { extension } from '@heyputer/backend/src/extensions';
+import { PuterService } from '@heyputer/backend/src/services/types.js';
+import { nativeImport } from '@heyputer/backend/src/util/nativeImport.js';
+import { spawn, type ChildProcess } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+const requireFromHere = createRequire(__filename);
+const webpack = requireFromHere('webpack') as typeof import('webpack');
+
+type EnvFactory = (args: {
+    global_config: Record<string, unknown> | null;
+}) => string | undefined;
+
+type EnvMap = Record<string, string | undefined | EnvFactory>;
+
+type CommandEntry = {
+    name: string;
+    directory: string;
+    command: string;
+    args?: string[];
+    env?: EnvMap;
+};
+
+type WebpackEntry = {
+    name?: string;
+    directory: string;
+    env?: EnvMap;
+    onConfig?: (config: Record<string, unknown>) => void;
+};
+
+type WebpackStats = {
+    hasErrors: () => boolean;
+    toJson: (options: Record<string, unknown>) => {
+        errors?: Array<{ message?: string }>;
+        warnings?: Array<{ message?: string }>;
+    };
+};
+
+type DevWatcherConfig = {
+    enabled?: boolean;
+    root?: string;
+    commands?: CommandEntry[];
+    webpack?: WebpackEntry[];
+    ready_delay_ms?: number;
+};
+
+class ProxyLogger {
+    #buffer = '';
+
+    constructor(private readonly log: (line: string) => void) {}
+
+    attach(stream: NodeJS.ReadableStream | null): void {
+        if (!stream) return;
+        stream.on('data', (chunk) => {
+            this.#buffer += chunk.toString();
+            let lineEndIndex = this.#buffer.indexOf('\n');
+            while (lineEndIndex !== -1) {
+                const line = this.#buffer.substring(0, lineEndIndex);
+                this.log(line);
+                this.#buffer = this.#buffer.substring(lineEndIndex + 1);
+                lineEndIndex = this.#buffer.indexOf('\n');
+            }
+        });
+
+        stream.on('end', () => {
+            if (this.#buffer.length) {
+                this.log(this.#buffer);
+                this.#buffer = '';
+            }
+        });
+    }
+}
+
+const findPackageRoot = (): string => {
+    let dir = __dirname;
+    for (;;) {
+        if (
+            existsSync(path.join(dir, 'package.json')) &&
+            existsSync(path.join(dir, 'src', 'gui')) &&
+            existsSync(path.join(dir, 'src', 'puter-js'))
+        ) {
+            return dir;
+        }
+
+        const parent = path.dirname(dir);
+        if (parent === dir) break;
+        dir = parent;
+    }
+
+    return path.resolve(__dirname, '..', '..');
+};
+
+const resolveFromRoot = (root: string, value: string): string =>
+    path.isAbsolute(value) ? value : path.resolve(root, value);
+
+const defaultWebpackEntries: WebpackEntry[] = [
+    {
+        name: 'puter.js',
+        directory: 'src/puter-js',
+        onConfig: (config) => {
+            const output = (config.output ?? {}) as Record<string, unknown>;
+            output.filename = 'puter.dev.js';
+            config.output = output;
+            config.devtool = 'source-map';
+        },
+        env: {
+            PUTER_ORIGIN: ({ global_config }) =>
+                String(global_config?.origin ?? ''),
+            PUTER_API_ORIGIN: ({ global_config }) =>
+                String(global_config?.api_base_url ?? ''),
+        },
+    },
+    {
+        name: 'gui',
+        directory: 'src/gui',
+    },
+];
+
+class DevWatcherService extends PuterService {
+    #processes: Array<{ name: string; proc: ChildProcess }> = [];
+    #watchers: ReturnType<ReturnType<typeof webpack>['watch']>[] = [];
+    #started = false;
+    #packageRoot = findPackageRoot();
+
+    override async onServerStart(): Promise<void> {
+        if (!this.#shouldStart()) return;
+        if (this.#started) return;
+        this.#started = true;
+
+        const devwatch = this.#devwatchConfig();
+        const root = resolveFromRoot(
+            this.#packageRoot,
+            devwatch.root ?? this.#packageRoot,
+        );
+        const commands = devwatch.commands ?? [];
+        const webpackEntries = devwatch.webpack ?? defaultWebpackEntries;
+
+        console.log(`[devwatch] starting watchers from ${root}`);
+        await Promise.all([
+            ...commands.map((entry) => this.#startCommand(root, entry)),
+            ...webpackEntries.map((entry) =>
+                this.#startWebpackWatcher(root, entry),
+            ),
+        ]);
+
+        const readyDelayMs = devwatch.ready_delay_ms ?? 5000;
+        if (readyDelayMs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, readyDelayMs));
+        }
+    }
+
+    override async onServerShutdown(): Promise<void> {
+        await Promise.all(
+            this.#watchers.map(
+                (watcher) =>
+                    new Promise<void>((resolve) => {
+                        watcher?.close((err) => {
+                            if (err) {
+                                console.warn(
+                                    '[devwatch] failed to close webpack watcher:',
+                                    err,
+                                );
+                            }
+                            resolve();
+                        });
+                    }),
+            ),
+        );
+        this.#watchers = [];
+
+        for (const { name, proc } of this.#processes) {
+            if (proc.exitCode !== null || proc.killed) continue;
+            console.log(`[devwatch:${name}] stopping process`);
+            proc.kill();
+        }
+        this.#processes = [];
+    }
+
+    #devwatchConfig(): DevWatcherConfig {
+        const raw = (this.config as Record<string, unknown>).devwatch;
+        return raw && typeof raw === 'object' ? (raw as DevWatcherConfig) : {};
+    }
+
+    #shouldStart(): boolean {
+        const config = this.config as Record<string, unknown>;
+        const devwatch = this.#devwatchConfig();
+
+        if (config.no_devwatch === true) return false;
+        if (devwatch.enabled === false) return false;
+        if (devwatch.enabled === true) return true;
+
+        return this.config.env === 'dev';
+    }
+
+    async #startCommand(root: string, entry: CommandEntry): Promise<void> {
+        const fullpath = resolveFromRoot(root, entry.directory);
+        console.log(`[devwatch] starting ${entry.name} in ${fullpath}`);
+
+        const proc = spawn(entry.command, entry.args ?? [], {
+            shell: true,
+            cwd: fullpath,
+            env: {
+                ...process.env,
+                ...this.#evaluateEnv(entry.env),
+            },
+        });
+        this.#processes.push({ name: entry.name, proc });
+
+        new ProxyLogger((line) =>
+            console.log(`[devwatch:${entry.name}:1] ${line}`),
+        ).attach(proc.stdout);
+        new ProxyLogger((line) =>
+            console.warn(`[devwatch:${entry.name}:2] ${line}`),
+        ).attach(proc.stderr);
+
+        proc.on('exit', () => {
+            console.log(
+                `[devwatch:${entry.name}:exit] process exited (${proc.exitCode})`,
+            );
+            this.#processes = this.#processes.filter(
+                (instance) => instance.proc !== proc,
+            );
+        });
+    }
+
+    async #startWebpackWatcher(
+        root: string,
+        entry: WebpackEntry,
+    ): Promise<void> {
+        const directory = entry.directory;
+        let { configjsPath: webpackConfigPath, moduleType } = this.#getConfigJs(
+            {
+                root,
+                directory,
+                configIsFor: 'webpack',
+                possibleConfigNames: [
+                    ['webpack.config.js', 'package.json'],
+                    ['webpack.config.cjs', 'commonjs'],
+                    ['webpack.config.mjs', 'module'],
+                ],
+            },
+        );
+
+        let webpackConfig = await this.#withEnv(entry.env, async () => {
+            if (moduleType === 'module') {
+                webpackConfigPath = pathToFileURL(webpackConfigPath).href;
+                const imported = await nativeImport<{ default?: unknown }>(
+                    webpackConfigPath,
+                );
+                return imported.default ?? imported;
+            }
+            return requireFromHere(webpackConfigPath);
+        });
+
+        if (typeof webpackConfig === 'function') {
+            webpackConfig = await this.#withEnv(entry.env, () =>
+                (webpackConfig as () => unknown)(),
+            );
+        }
+
+        this.#normalizeWebpackContext(root, directory, webpackConfig);
+        if (entry.onConfig) {
+            entry.onConfig(webpackConfig as Record<string, unknown>);
+        }
+
+        const compiler = webpack(
+            webpackConfig as Parameters<typeof webpack>[0],
+        );
+        const watcher = compiler.watch({}, (err, stats) => {
+            this.#handleWebpackUpdate(entry, err, stats);
+        });
+        this.#watchers.push(watcher);
+    }
+
+    #getConfigJs(args: {
+        root: string;
+        directory: string;
+        configIsFor: string;
+        possibleConfigNames: Array<
+            [string, 'package.json' | 'commonjs' | 'module']
+        >;
+    }): {
+        configjsPath: string;
+        moduleType: 'commonjs' | 'module';
+    } {
+        const { root, directory, configIsFor, possibleConfigNames } = args;
+        let configjsPath: string | undefined;
+        let moduleType: 'package.json' | 'commonjs' | 'module' | undefined;
+
+        for (const [configName, supposedModuleType] of possibleConfigNames) {
+            const supposedPath = path.join(root, directory, configName);
+            if (existsSync(supposedPath)) {
+                configjsPath = supposedPath;
+                moduleType = supposedModuleType;
+                break;
+            }
+        }
+
+        if (!configjsPath || !moduleType) {
+            throw new Error(
+                `could not find ${configIsFor} config for: ${directory}`,
+            );
+        }
+
+        if (moduleType === 'package.json') {
+            const packageJSONPath = path.join(root, directory, 'package.json');
+            const packageJSONObject = JSON.parse(
+                readFileSync(packageJSONPath, 'utf8'),
+            ) as { type?: 'commonjs' | 'module' };
+            moduleType = packageJSONObject.type ?? 'module';
+        }
+
+        return {
+            configjsPath,
+            moduleType,
+        };
+    }
+
+    async #withEnv<T>(env: EnvMap | undefined, fn: () => T | Promise<T>) {
+        if (!env) return fn();
+
+        const oldEnv = process.env;
+        process.env = {
+            ...oldEnv,
+            ...this.#evaluateEnv(env),
+        };
+
+        try {
+            return await fn();
+        } finally {
+            process.env = oldEnv;
+        }
+    }
+
+    #evaluateEnv(env: EnvMap | undefined): Record<string, string> {
+        const out: Record<string, string> = {};
+        if (!env) return out;
+
+        for (const [key, value] of Object.entries(env)) {
+            try {
+                const evaluated =
+                    typeof value === 'function'
+                        ? value({
+                              global_config: this.config as Record<
+                                  string,
+                                  unknown
+                              >,
+                          })
+                        : value;
+                if (evaluated) out[key] = String(evaluated);
+            } catch (e) {
+                const msg = (e as Error).message;
+                if (
+                    !msg.includes('Cannot read properties of null') &&
+                    !msg.includes('Cannot read properties of undefined')
+                ) {
+                    console.warn(
+                        `[devwatch] could not evaluate env function for ${key}: ${msg}`,
+                    );
+                }
+            }
+        }
+        return out;
+    }
+
+    #normalizeWebpackContext(
+        root: string,
+        directory: string,
+        webpackConfig: unknown,
+    ): void {
+        const configs = Array.isArray(webpackConfig)
+            ? webpackConfig
+            : [webpackConfig];
+
+        for (const config of configs) {
+            if (!config || typeof config !== 'object') continue;
+            const obj = config as Record<string, unknown>;
+            obj.context = obj.context
+                ? path.resolve(path.join(root, directory), String(obj.context))
+                : path.join(root, directory);
+        }
+    }
+
+    #handleWebpackUpdate(
+        entry: WebpackEntry,
+        err: Error | null | undefined,
+        stats: WebpackStats | undefined,
+    ): void {
+        const name = entry.name ?? entry.directory;
+        const firstEventKey = `__devwatch_first_${entry.directory}`;
+        const firstEvent = !(entry as Record<string, unknown>)[firstEventKey];
+        (entry as Record<string, unknown>)[firstEventKey] = true;
+
+        if (err || stats?.hasErrors()) {
+            const info = stats?.toJson({
+                all: false,
+                errors: true,
+                warnings: true,
+            });
+            console.error(
+                `[devwatch] error information: ${name} using Webpack`,
+                {
+                    err: err ? err.message : null,
+                    errors: info?.errors?.map((e) => e.message) ?? [],
+                    warnings: info?.warnings?.map((w) => w.message) ?? [],
+                },
+            );
+            console.error(`[devwatch] failed to update ${name} using Webpack`);
+            return;
+        }
+
+        if (!firstEvent) {
+            console.log(`[devwatch] updated ${name} using Webpack`);
+        }
+    }
+}
+
+extension.registerService('devWatcher', DevWatcherService);

extensions/installedApps.test.ts

@@ -0,0 +1,156 @@
+import type { Request, Response } from 'express';
+import { v4 as uuidv4 } from 'uuid';
+import {
+    afterAll,
+    beforeAll,
+    describe,
+    expect,
+    it,
+    vi,
+} from 'vitest';
+import { runWithContext } from '../src/backend/core/context.ts';
+import { PuterServer } from '../src/backend/server.ts';
+import { setupTestServer } from '../src/backend/testUtil.ts';
+import { handleInstalledApps } from './installedApps.ts';
+
+interface CapturedResponse {
+    body: unknown;
+}
+
+const makeReq = (query: Record<string, unknown> = {}): Request =>
+    ({ query }) as unknown as Request;
+
+const makeRes = () => {
+    const captured: CapturedResponse = { body: undefined };
+    const res = {
+        json: vi.fn((value: unknown) => {
+            captured.body = value;
+            return res;
+        }),
+    };
+    return { res: res as unknown as Response, captured };
+};
+
+let server: PuterServer;
+
+beforeAll(async () => {
+    server = await setupTestServer();
+});
+
+afterAll(async () => {
+    await server.shutdown();
+});
+
+const seedUser = async () => {
+    const slug = Math.random().toString(36).slice(2, 8);
+    return server.stores.user.create({
+        username: `iauser_${slug}`,
+        uuid: uuidv4(),
+        password: 'x',
+        email: null,
+    });
+};
+
+const seedApp = async (ownerUserId: number) => {
+    const slug = Math.random().toString(36).slice(2, 8);
+    return server.stores.app.create(
+        {
+            name: `iaapp_${slug}`,
+            title: `Installed App ${slug}`,
+            index_url: `https://example.com/${slug}`,
+        },
+        { ownerUserId },
+    );
+};
+
+const grantInstalled = async (appId: number, userId: number) => {
+    // Mimic the `flag:app-is-authenticated` perm row the handler joins on.
+    await server.clients.db.write(
+        `INSERT INTO user_to_app_permissions (user_id, app_id, permission, extra) VALUES (?, ?, ?, ?)`,
+        [userId, appId, 'flag:app-is-authenticated', null],
+    );
+};
+
+describe('installedApps extension — handleInstalledApps', () => {
+    it('throws HttpError(401) when no actor is on the context', async () => {
+        const { res } = makeRes();
+        await expect(
+            runWithContext({ actor: undefined }, () =>
+                handleInstalledApps(makeReq({}), res),
+            ),
+        ).rejects.toMatchObject({ statusCode: 401 });
+    });
+
+    it('throws HttpError(400) when orderBy is not in the allowlist', async () => {
+        const user = await seedUser();
+        const { res } = makeRes();
+        await expect(
+            runWithContext(
+                {
+                    actor: {
+                        user: { uuid: user.uuid, id: user.id as number },
+                    },
+                },
+                () =>
+                    handleInstalledApps(
+                        // SQL injection attempt — must be rejected.
+                        makeReq({ orderBy: 'apps.id; DROP TABLE apps;--' }),
+                        res,
+                    ),
+            ),
+        ).rejects.toMatchObject({
+            statusCode: 400,
+            message: expect.stringContaining('Invalid orderBy'),
+        });
+    });
+
+    it('returns an empty list for a user with no installed apps', async () => {
+        const user = await seedUser();
+        const { res, captured } = makeRes();
+
+        await runWithContext(
+            { actor: { user: { uuid: user.uuid, id: user.id as number } } },
+            () => handleInstalledApps(makeReq({}), res),
+        );
+
+        expect(captured.body).toEqual([]);
+    });
+
+    it('returns the caller’s installed apps with an iconUrl field', async () => {
+        const user = await seedUser();
+        const app = await seedApp(user.id as number);
+        await grantInstalled(app!.id as number, user.id as number);
+
+        const { res, captured } = makeRes();
+        await runWithContext(
+            { actor: { user: { uuid: user.uuid, id: user.id as number } } },
+            () => handleInstalledApps(makeReq({}), res),
+        );
+
+        const list = captured.body as Array<Record<string, unknown>>;
+        expect(list).toHaveLength(1);
+        expect(list[0].uid).toBe(app!.uid);
+        expect(list[0].name).toBe(app!.name);
+        expect(list[0].title).toBe(app!.title);
+        expect(Object.prototype.hasOwnProperty.call(list[0], 'iconUrl')).toBe(
+            true,
+        );
+    });
+
+    it('clamps page/limit to safe ranges (page>=1, 1<=limit<=100)', async () => {
+        const user = await seedUser();
+        const { res, captured } = makeRes();
+
+        // page=0 and limit=999 should be clamped without throwing.
+        await runWithContext(
+            { actor: { user: { uuid: user.uuid, id: user.id as number } } },
+            () =>
+                handleInstalledApps(
+                    makeReq({ page: 0, limit: 999, desc: '1' }),
+                    res,
+                ),
+        );
+
+        expect(Array.isArray(captured.body)).toBe(true);
+    });
+});

extensions/installedApps.ts

@@ -0,0 +1,76 @@
+import type { Request, Response } from 'express';
+import { Context } from '@heyputer/backend/src/core';
+import { HttpError } from '@heyputer/backend/src/core/http';
+import { extension } from '@heyputer/backend/src/extensions';
+import { getAppIconUrl } from '@heyputer/backend/src/util/appIcon.js';
+
+const clients = extension.import('client');
+
+const ALLOWED_ORDER_BY = [
+    'id',
+    'name',
+    'uid',
+    'title',
+    'installed_at',
+] as const;
+const ORDER_BY_FIELD_MAP: Record<string, string> = {
+    id: 'apps.id',
+    name: 'apps.name',
+    uid: 'apps.uid',
+    title: 'apps.title',
+    installed_at: 'installed_at',
+};
+
+export const handleInstalledApps = async (
+    req: Request,
+    res: Response,
+): Promise<void> => {
+    const actor = Context.get('actor');
+    if (!actor?.user?.id) throw new HttpError(401, 'Authentication required');
+
+    const orderBy = String(req.query.orderBy ?? 'installed_at');
+    if (!(ALLOWED_ORDER_BY as readonly string[]).includes(orderBy)) {
+        throw new HttpError(
+            400,
+            `Invalid orderBy. Allowed: ${ALLOWED_ORDER_BY.join(', ')}`,
+        );
+    }
+
+    const page = Math.max(Number(req.query.page) || 1, 1);
+    const limit = Math.min(Math.max(Number(req.query.limit) || 100, 1), 100);
+    const offset = (page - 1) * limit;
+    const orderByField = ORDER_BY_FIELD_MAP[orderBy];
+    const sortDirection = req.query.desc ? 'DESC' : 'ASC';
+
+    const installedApps = (await clients.db.read(
+        `SELECT
+            apps.name,
+            apps.uid,
+            apps.title,
+            apps.description,
+            apps.icon,
+            MIN(perm.dt) AS installed_at
+        FROM apps
+        LEFT JOIN user_to_app_permissions AS perm ON apps.id = perm.app_id
+        WHERE perm.user_id = ?
+        GROUP BY apps.id, apps.name, apps.uid, apps.title, apps.description
+        ORDER BY ${orderByField} ${sortDirection}
+        LIMIT ?
+        OFFSET ?`,
+        [actor.user.id, limit, offset],
+    )) as Array<Record<string, unknown>>;
+
+    const apiBaseUrl = extension.config.api_base_url as string | undefined;
+    res.json(
+        installedApps.map((app) => ({
+            ...app,
+            iconUrl: getAppIconUrl(app, { apiBaseUrl }),
+        })),
+    );
+};
+
+extension.get(
+    '/installedApps',
+    { subdomain: 'api', requireUserActor: true },
+    handleInstalledApps,
+);

extensions/metering.test.ts

@@ -0,0 +1,168 @@
+import type { Request, Response } from 'express';
+import { v4 as uuidv4 } from 'uuid';
+import {
+    afterAll,
+    beforeAll,
+    describe,
+    expect,
+    it,
+    vi,
+} from 'vitest';
+import { runWithContext } from '../src/backend/core/context.ts';
+import { PuterServer } from '../src/backend/server.ts';
+import { setupTestServer } from '../src/backend/testUtil.ts';
+import {
+    handleMeteringAllCosts,
+    handleMeteringGlobalUsage,
+    handleMeteringUsage,
+    handleMeteringUsageForApp,
+} from './metering.ts';
+
+interface CapturedResponse {
+    body: unknown;
+}
+
+const makeReq = (
+    init: { params?: Record<string, unknown> } = {},
+): Request =>
+    ({
+        params: init.params ?? {},
+        query: {},
+    }) as unknown as Request;
+
+const makeRes = () => {
+    const captured: CapturedResponse = { body: undefined };
+    const res = {
+        json: vi.fn((value: unknown) => {
+            captured.body = value;
+            return res;
+        }),
+    };
+    return { res: res as unknown as Response, captured };
+};
+
+let server: PuterServer;
+
+beforeAll(async () => {
+    server = await setupTestServer();
+});
+
+afterAll(async () => {
+    await server.shutdown();
+});
+
+const seedUser = async () => {
+    const slug = Math.random().toString(36).slice(2, 8);
+    return server.stores.user.create({
+        username: `muser_${slug}`,
+        uuid: uuidv4(),
+        password: 'x',
+        email: null,
+    });
+};
+
+describe('metering extension — handleMeteringUsage', () => {
+    it('throws HttpError(401) when no user actor is on the context', async () => {
+        const { res } = makeRes();
+        await expect(
+            runWithContext({ actor: undefined }, () =>
+                handleMeteringUsage(makeReq(), res),
+            ),
+        ).rejects.toMatchObject({ statusCode: 401 });
+    });
+
+    it('returns usage details merged with allowanceInfo for an authenticated user', async () => {
+        const user = await seedUser();
+        const { res, captured } = makeRes();
+
+        await runWithContext(
+            { actor: { user: { uuid: user.uuid, id: user.id as number } } },
+            () => handleMeteringUsage(makeReq(), res),
+        );
+
+        // We don't assert the inner shape (provider-specific) — only that
+        // the handler returned a JSON object that carries `allowanceInfo`.
+        expect(typeof captured.body).toBe('object');
+        expect(captured.body).not.toBeNull();
+        expect(
+            (captured.body as Record<string, unknown>).allowanceInfo,
+        ).toBeDefined();
+    });
+});
+
+describe('metering extension — handleMeteringUsageForApp', () => {
+    it('throws HttpError(401) when no user actor is on the context', async () => {
+        const { res } = makeRes();
+        await expect(
+            runWithContext({ actor: undefined }, () =>
+                handleMeteringUsageForApp(
+                    makeReq({ params: { appIdOrName: 'any' } }),
+                    res,
+                ),
+            ),
+        ).rejects.toMatchObject({ statusCode: 401 });
+    });
+
+    it('throws HttpError(400) when no appId is supplied', async () => {
+        const user = await seedUser();
+        const { res } = makeRes();
+        await expect(
+            runWithContext(
+                { actor: { user: { uuid: user.uuid, id: user.id as number } } },
+                () =>
+                    handleMeteringUsageForApp(
+                        makeReq({ params: { appIdOrName: '' } }),
+                        res,
+                    ),
+            ),
+        ).rejects.toMatchObject({ statusCode: 400 });
+    });
+
+    it('throws HttpError(404) when looking up an unknown app by name', async () => {
+        const user = await seedUser();
+        const { res } = makeRes();
+        await expect(
+            runWithContext(
+                { actor: { user: { uuid: user.uuid, id: user.id as number } } },
+                () =>
+                    handleMeteringUsageForApp(
+                        makeReq({ params: { appIdOrName: 'no-such-app' } }),
+                        res,
+                    ),
+            ),
+        ).rejects.toMatchObject({ statusCode: 404 });
+    });
+});
+
+describe('metering extension — handleMeteringGlobalUsage', () => {
+    it('returns the global usage payload from MeteringService', async () => {
+        const { res, captured } = makeRes();
+        await handleMeteringGlobalUsage(makeReq(), res);
+        // Just confirm a JSON body was returned. Inner shape comes from
+        // MeteringService and is covered elsewhere.
+        expect(captured.body).toBeDefined();
+    });
+});
+
+describe('metering extension — handleMeteringAllCosts', () => {
+    it('returns a { costs: [...] } payload', async () => {
+        const { res, captured } = makeRes();
+        await handleMeteringAllCosts(makeReq(), res);
+        const body = captured.body as { costs: unknown };
+        expect(Array.isArray(body.costs)).toBe(true);
+    });
+
+    it('caches the costs catalogue across calls (same array reference)', async () => {
+        const a = makeRes();
+        const b = makeRes();
+        await handleMeteringAllCosts(makeReq(), a.res);
+        await handleMeteringAllCosts(makeReq(), b.res);
+
+        const costsA = (a.captured.body as { costs: unknown[] }).costs;
+        const costsB = (b.captured.body as { costs: unknown[] }).costs;
+        // Cache fields the same array instance — this is the property we
+        // actually want to lock down (no rewalk of every driver/controller
+        // per request).
+        expect(costsA).toBe(costsB);
+    });
+});

extensions/metering.ts

@@ -0,0 +1,135 @@
+import type { Request, Response } from 'express';
+import { Context } from '@heyputer/backend/src/core';
+import { HttpError } from '@heyputer/backend/src/core/http';
+import {
+    controllersContainers,
+    driversContainers,
+} from '@heyputer/backend/src/exports';
+import { extension } from '@heyputer/backend/src/extensions';
+
+const services = extension.import('service');
+const clients = extension.import('client');
+
+// Cached on first request — the underlying cost catalogues are baked into
+// driver/controller source so they only change on deploy.
+let cachedAllCosts: Record<string, unknown>[] | null = null;
+
+function collectAllCosts(): Record<string, unknown>[] {
+    const all: Record<string, unknown>[] = [];
+    const collect = (
+        source: Record<string, unknown>,
+        kind: 'driver' | 'controller',
+    ) => {
+        for (const [name, instance] of Object.entries(source)) {
+            const fn = (
+                instance as {
+                    getReportedCosts?: () => Record<string, unknown>[];
+                }
+            )?.getReportedCosts;
+            if (typeof fn !== 'function') continue;
+            try {
+                const entries = fn.call(instance);
+                if (!Array.isArray(entries)) continue;
+                for (const entry of entries) {
+                    all.push({ ...entry, registry: kind, registryKey: name });
+                }
+            } catch (e) {
+                console.warn(
+                    `[metering] getReportedCosts failed for ${kind}:${name}:`,
+                    (e as Error).message,
+                );
+            }
+        }
+    };
+    collect(driversContainers as Record<string, unknown>, 'driver');
+    collect(controllersContainers as Record<string, unknown>, 'controller');
+    return all;
+}
+
+export const handleMeteringUsage = async (
+    _req: Request,
+    res: Response,
+): Promise<void> => {
+    const actor = Context.get('actor');
+    if (!actor?.user) throw new HttpError(401, 'Authentication required');
+
+    const [actorUsage, allowanceInfo] = await Promise.all([
+        services.metering.getActorCurrentMonthUsageDetails(actor),
+        services.metering.getAllowedUsage(actor),
+    ]);
+    res.json({ ...actorUsage, allowanceInfo });
+};
+
+export const handleMeteringUsageForApp = async (
+    req: Request,
+    res: Response,
+): Promise<void> => {
+    const actor = Context.get('actor');
+    if (!actor?.user) throw new HttpError(401, 'Authentication required');
+
+    let appId = String(req.params.appIdOrName ?? '');
+    if (!appId) throw new HttpError(400, 'appId parameter is required');
+
+    // If not a UUID-shaped app UID, look up by name
+    if (!appId.startsWith('app-')) {
+        const appRows = (await clients.db.read(
+            'SELECT `uid` FROM `apps` WHERE `name` = ? LIMIT 1',
+            [appId],
+        )) as Array<{ uid: string }>;
+        if (appRows.length > 0) {
+            appId = appRows[0].uid;
+        } else {
+            throw new HttpError(404, 'App not found');
+        }
+    }
+
+    const appUsage =
+        await services.metering.getActorCurrentMonthAppUsageDetails(
+            actor,
+            appId,
+        );
+    res.json(appUsage);
+};
+
+export const handleMeteringGlobalUsage = async (
+    _req: Request,
+    res: Response,
+): Promise<void> => {
+    const globalUsage = await services.metering.getGlobalUsage();
+    res.json(globalUsage);
+};
+
+// First hit walks the registries; subsequent hits serve the in-memory cache.
+export const handleMeteringAllCosts = async (
+    _req: Request,
+    res: Response,
+): Promise<void> => {
+    if (!cachedAllCosts) {
+        cachedAllCosts = collectAllCosts();
+    }
+    res.json({ costs: cachedAllCosts });
+};
+
+extension.get(
+    '/metering/usage',
+    { subdomain: 'api', requireAuth: true },
+    handleMeteringUsage,
+);
+
+extension.get(
+    '/metering/usage/:appIdOrName',
+    { subdomain: 'api', requireAuth: true },
+    handleMeteringUsageForApp,
+);
+
+extension.get(
+    '/metering/globalUsage',
+    { subdomain: 'api', adminOnly: true },
+    handleMeteringGlobalUsage,
+);
+
+extension.get(
+    '/metering/allCosts',
+    { subdomain: 'api', requireAuth: true },
+    handleMeteringAllCosts,
+);

extensions/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "commonjs"
+}

extensions/serverInfo.test.ts

@@ -0,0 +1,91 @@
+import type { Request, Response } from 'express';
+import { describe, expect, it, vi } from 'vitest';
+import { handleServerInfo } from './serverInfo.ts';
+
+interface CapturedResponse {
+    body: Record<string, unknown> | undefined;
+}
+
+const makeRes = () => {
+    const captured: CapturedResponse = { body: undefined };
+    const res = {
+        json: vi.fn((value: Record<string, unknown>) => {
+            captured.body = value;
+            return res;
+        }),
+    };
+    return { res: res as unknown as Response, captured };
+};
+
+describe('serverInfo extension — handleServerInfo', () => {
+    it('returns the full server info payload', async () => {
+        const { res, captured } = makeRes();
+
+        await handleServerInfo({} as Request, res);
+
+        expect(captured.body).toBeDefined();
+        const body = captured.body!;
+
+        // OS section
+        const os = body.os as Record<string, unknown>;
+        expect(typeof os.platform).toBe('string');
+        expect(typeof os.type).toBe('string');
+        expect(typeof os.release).toBe('string');
+        expect(os.pretty).toBe(`${os.type} ${os.release}`);
+
+        // CPU section
+        const cpu = body.cpu as Record<string, unknown>;
+        expect(typeof cpu.model).toBe('string');
+        expect(typeof cpu.cores).toBe('number');
+        expect((cpu.cores as number) > 0).toBe(true);
+
+        // RAM — totalGB / freeGB are stringified two-decimal values
+        const ram = body.ram as Record<string, unknown>;
+        expect(typeof ram.total).toBe('number');
+        expect(typeof ram.free).toBe('number');
+        expect(ram.totalGB).toMatch(/^\d+\.\d{2}$/);
+        expect(ram.freeGB).toMatch(/^\d+\.\d{2}$/);
+
+        // Uptime fields are numeric (seconds/days/hours/minutes) plus pretty.
+        const uptime = body.uptime as Record<string, unknown>;
+        expect(typeof uptime.seconds).toBe('number');
+        expect(typeof uptime.days).toBe('number');
+        expect(typeof uptime.hours).toBe('number');
+        expect(typeof uptime.minutes).toBe('number');
+        expect(uptime.pretty).toMatch(/^\d+d \d+h \d+m$/);
+
+        // Disk may fall through to N/A when statfs throws (e.g. unsupported
+        // platforms), so accept either the success shape or the fallback.
+        const disk = body.disk as Record<string, unknown>;
+        expect(['N/A']).toContain(disk.total === 'N/A' ? 'N/A' : 'N/A'); // keep shape-only assertion
+        expect(typeof disk.total).toBe('string');
+        expect(typeof disk.free).toBe('string');
+        expect(typeof disk.used).toBe('string');
+
+        expect(Array.isArray(body.loadavg)).toBe(true);
+        expect(typeof body.hostname).toBe('string');
+    });
+
+    it('falls back to N/A disk stats when statfs throws', async () => {
+        const fs = await import('node:fs/promises');
+        const statfsSpy = vi
+            .spyOn(fs.default, 'statfs')
+            .mockRejectedValue(new Error('statfs unsupported'));
+        const errSpy = vi
+            .spyOn(console, 'error')
+            .mockImplementation(() => {});
+
+        const { res, captured } = makeRes();
+        await handleServerInfo({} as Request, res);
+
+        const disk = (captured.body as Record<string, unknown>).disk as Record<
+            string,
+            string
+        >;
+        expect(disk).toEqual({ total: 'N/A', free: 'N/A', used: 'N/A' });
+        expect(errSpy).toHaveBeenCalled();
+
+        statfsSpy.mockRestore();
+        errSpy.mockRestore();
+    });
+});

extensions/serverInfo.ts

@@ -0,0 +1,73 @@
+import type { Request, Response } from 'express';
+import { extension } from '@heyputer/backend/src/extensions';
+import fs from 'fs/promises';
+import os from 'os';
+
+export const handleServerInfo = async (
+    _req: Request,
+    res: Response,
+): Promise<void> => {
+    const osData = {
+        platform: os.platform(),
+        type: os.type(),
+        release: os.release(),
+        pretty: `${os.type()} ${os.release()}`,
+    };
+
+    const cpus = os.cpus();
+    const cpuData = {
+        model: cpus[0]?.model || 'Unknown',
+        cores: cpus.length,
+    };
+
+    const ramData = {
+        total: os.totalmem(),
+        free: os.freemem(),
+        totalGB: (os.totalmem() / 1073741824).toFixed(2),
+        freeGB: (os.freemem() / 1073741824).toFixed(2),
+    };
+
+    const uptimeSeconds = os.uptime();
+    const uptimeData = {
+        seconds: uptimeSeconds,
+        days: Math.floor(uptimeSeconds / 86400),
+        hours: Math.floor((uptimeSeconds % 86400) / 3600),
+        minutes: Math.floor((uptimeSeconds % 3600) / 60),
+        pretty: `${Math.floor(uptimeSeconds / 86400)}d ${Math.floor((uptimeSeconds % 86400) / 3600)}h ${Math.floor((uptimeSeconds % 3600) / 60)}m`,
+    };
+
+    let diskData: Record<string, string> = {
+        total: 'N/A',
+        free: 'N/A',
+        used: 'N/A',
+    };
+    try {
+        const stats = await fs.statfs('/');
+        const totalGB = (stats.blocks * stats.bsize) / 1073741824;
+        const freeGB = (stats.bfree * stats.bsize) / 1073741824;
+        const usedGB = (totalGB - freeGB).toFixed(2);
+        diskData = {
+            total: totalGB.toFixed(2),
+            free: freeGB.toFixed(2),
+            used: usedGB,
+        };
+    } catch (err) {
+        console.error('Disk stats error:', err);
+    }
+
+    res.json({
+        os: osData,
+        cpu: cpuData,
+        ram: ramData,
+        uptime: uptimeData,
+        disk: diskData,
+        loadavg: os.loadavg(),
+        hostname: os.hostname(),
+    });
+};
+
+extension.get(
+    '/serverInfo',
+    { subdomain: 'api', adminOnly: true },
+    handleServerInfo,
+);

extensions/thumbnails.test.ts

@@ -0,0 +1,320 @@
+import {
+    GetObjectCommand,
+    PutObjectCommand,
+    type S3Client,
+} from '@aws-sdk/client-s3';
+import {
+    afterAll,
+    beforeAll,
+    describe,
+    expect,
+    it,
+    vi,
+} from 'vitest';
+import { PuterServer } from '../src/backend/server.ts';
+import { setupTestServer } from '../src/backend/testUtil.ts';
+import {
+    handleFsRemoveNodeThumbnail,
+    handleThumbnailCreated,
+    handleThumbnailRead,
+    handleThumbnailUploadPrepare,
+} from './thumbnails.ts';
+
+// 1x1 transparent PNG — smallest valid image sharp will accept.
+const TINY_PNG_BASE64 =
+    'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';
+
+const BUCKET = 'puter-local';
+
+const streamToBuffer = async (
+    body: { transformToByteArray: () => Promise<Uint8Array> } | undefined,
+): Promise<Buffer> => {
+    if (!body) throw new Error('s3 GetObject returned no body');
+    return Buffer.from(await body.transformToByteArray());
+};
+
+describe('thumbnails extension — handleThumbnailCreated', () => {
+    let server: PuterServer;
+
+    beforeAll(async () => {
+        server = await setupTestServer();
+    });
+
+    afterAll(async () => {
+        await server.shutdown();
+    });
+
+    it('uploads a valid data: URL thumbnail to S3 and rewrites event.url to an s3:// pointer', async () => {
+        const s3 = server.clients.s3.get();
+        const event: Record<string, unknown> = {
+            url: `data:image/png;base64,${TINY_PNG_BASE64}`,
+        };
+
+        await handleThumbnailCreated(event, { s3, bucketName: BUCKET });
+
+        expect(typeof event.url).toBe('string');
+        const newUrl = event.url as string;
+        expect(newUrl.startsWith(`s3://${BUCKET}/`)).toBe(true);
+
+        const key = newUrl.slice(`s3://${BUCKET}/`.length);
+        const obj = await s3.send(
+            new GetObjectCommand({ Bucket: BUCKET, Key: key }),
+        );
+        expect(obj.ContentType).toBe('image/png');
+
+        const expected = Buffer.from(TINY_PNG_BASE64, 'base64');
+        const actual = await streamToBuffer(obj.Body as never);
+        expect(actual.equals(expected)).toBe(true);
+    });
+
+    it('sets event.url to null when the data: URL does not decode to a valid image', async () => {
+        const s3 = server.clients.s3.get();
+        const event: Record<string, unknown> = {
+            url: `data:image/png;base64,${Buffer.from('not an image').toString('base64')}`,
+        };
+
+        await handleThumbnailCreated(event, { s3, bucketName: BUCKET });
+
+        expect(event.url).toBeNull();
+    });
+
+    it('leaves event.url untouched when the URL is not a data: URL', async () => {
+        const s3 = server.clients.s3.get();
+        const original = 'https://example.com/thumb.png';
+        const event: Record<string, unknown> = { url: original };
+
+        await handleThumbnailCreated(event, { s3, bucketName: BUCKET });
+
+        expect(event.url).toBe(original);
+    });
+
+    it('returns without writing to S3 when event.url is missing', async () => {
+        const s3 = server.clients.s3.get();
+        const event: Record<string, unknown> = {};
+
+        await handleThumbnailCreated(event, { s3, bucketName: BUCKET });
+
+        expect(event.url).toBeUndefined();
+    });
+});
+
+describe('thumbnails extension — handleThumbnailUploadPrepare', () => {
+    let server: PuterServer;
+    let s3Presign: S3Client;
+
+    beforeAll(async () => {
+        server = await setupTestServer();
+        s3Presign = server.clients.s3.getForPresign();
+    });
+
+    afterAll(async () => {
+        await server.shutdown();
+    });
+
+    it('returns early when event has no items array', async () => {
+        const event: Record<string, unknown> = {};
+        await handleThumbnailUploadPrepare(event, {
+            s3Presign,
+            bucketName: BUCKET,
+        });
+        // No items property added — handler is a no-op.
+        expect(event).toEqual({});
+    });
+
+    it('throws when items array contains a non-object entry', async () => {
+        await expect(
+            handleThumbnailUploadPrepare(
+                { items: ['not-an-object'] } as unknown as Record<
+                    string,
+                    unknown
+                >,
+                { s3Presign, bucketName: BUCKET },
+            ),
+        ).rejects.toThrow('thumbnail.upload.prepare item is invalid');
+    });
+
+    it('skips items without a contentType (no upload URL minted)', async () => {
+        const item: Record<string, unknown> = { contentType: '' };
+        await handleThumbnailUploadPrepare(
+            { items: [item] },
+            { s3Presign, bucketName: BUCKET },
+        );
+        expect(item.uploadUrl).toBeUndefined();
+        expect(item.thumbnailUrl).toBeUndefined();
+    });
+
+    it('skips items whose size exceeds the max thumbnail bytes', async () => {
+        const item: Record<string, unknown> = {
+            contentType: 'image/png',
+            size: 999_999_999,
+        };
+        await handleThumbnailUploadPrepare(
+            { items: [item] },
+            { s3Presign, bucketName: BUCKET },
+        );
+        expect(item.uploadUrl).toBeUndefined();
+        expect(item.thumbnailUrl).toBeUndefined();
+    });
+
+    it('mints a presigned uploadUrl and an s3:// thumbnailUrl for valid items', async () => {
+        const item: Record<string, unknown> = {
+            contentType: 'image/png',
+            size: 1024,
+        };
+        await handleThumbnailUploadPrepare(
+            { items: [item] },
+            { s3Presign, bucketName: BUCKET },
+        );
+        expect(typeof item.uploadUrl).toBe('string');
+        expect((item.uploadUrl as string).startsWith('http')).toBe(true);
+        expect(typeof item.thumbnailUrl).toBe('string');
+        expect(
+            (item.thumbnailUrl as string).startsWith(`s3://${BUCKET}/`),
+        ).toBe(true);
+    });
+});
+
+describe('thumbnails extension — handleThumbnailRead', () => {
+    let server: PuterServer;
+    let s3: S3Client;
+    let s3Presign: S3Client;
+
+    const stubDb = { write: vi.fn().mockResolvedValue(undefined) };
+
+    beforeAll(async () => {
+        server = await setupTestServer();
+        s3 = server.clients.s3.get();
+        s3Presign = server.clients.s3.getForPresign();
+    });
+
+    afterAll(async () => {
+        await server.shutdown();
+    });
+
+    it('rewrites an s3:// thumbnail into a presigned https URL', async () => {
+        // Seed an object so the presigned URL points at something real
+        // (the signer itself doesn't validate existence, but this keeps
+        // the test honest).
+        const key = 'thumb-read-test';
+        await s3.send(
+            new PutObjectCommand({
+                Bucket: BUCKET,
+                Key: key,
+                Body: Buffer.from(TINY_PNG_BASE64, 'base64'),
+                ContentType: 'image/png',
+            }),
+        );
+
+        const entry: Record<string, unknown> = {
+            thumbnail: `s3://${BUCKET}/${key}`,
+        };
+        await handleThumbnailRead(entry, {
+            s3,
+            s3Presign,
+            bucketName: BUCKET,
+            bucketEndpoint: 'http://127.0.0.1:4566/puter-local/',
+            db: stubDb,
+        });
+
+        expect(typeof entry.thumbnail).toBe('string');
+        expect((entry.thumbnail as string).startsWith('http')).toBe(true);
+    });
+
+    it('leaves the thumbnail untouched when not s3/https/data', async () => {
+        const entry: Record<string, unknown> = { thumbnail: 'about:blank' };
+        await handleThumbnailRead(entry, {
+            s3,
+            s3Presign,
+            bucketName: BUCKET,
+            bucketEndpoint: 'http://127.0.0.1:4566/puter-local/',
+            db: stubDb,
+        });
+        expect(entry.thumbnail).toBe('about:blank');
+    });
+
+    it('returns early when the thumbnail is missing or non-string', async () => {
+        const entry: Record<string, unknown> = {};
+        await handleThumbnailRead(entry, {
+            s3,
+            s3Presign,
+            bucketName: BUCKET,
+            bucketEndpoint: 'http://127.0.0.1:4566/puter-local/',
+            db: stubDb,
+        });
+        expect(entry.thumbnail).toBeUndefined();
+    });
+
+    it('migrates an inline data: URL by uploading to S3 and updating the DB row', async () => {
+        const entry: Record<string, unknown> = {
+            uuid: 'fs-entry-uuid',
+            thumbnail: `data:image/png;base64,${TINY_PNG_BASE64}`,
+        };
+
+        await handleThumbnailRead(entry, {
+            s3,
+            s3Presign,
+            bucketName: BUCKET,
+            bucketEndpoint: 'http://127.0.0.1:4566/puter-local/',
+            db: stubDb,
+        });
+
+        // The handler should have replaced the data URL with a signed
+        // S3 URL and kicked off the DB migration write.
+        expect(typeof entry.thumbnail).toBe('string');
+        expect((entry.thumbnail as string).startsWith('http')).toBe(true);
+        // Allow the best-effort write microtask to settle.
+        await Promise.resolve();
+        expect(stubDb.write).toHaveBeenCalledWith(
+            'UPDATE `fsentries` SET `thumbnail` = ? WHERE `uuid` = ?',
+            [expect.stringMatching(/^s3:\/\//), 'fs-entry-uuid'],
+        );
+    });
+});
+
+describe('thumbnails extension — handleFsRemoveNodeThumbnail', () => {
+    let server: PuterServer;
+    let s3: S3Client;
+
+    beforeAll(async () => {
+        server = await setupTestServer();
+        s3 = server.clients.s3.get();
+    });
+
+    afterAll(async () => {
+        await server.shutdown();
+    });
+
+    it('deletes the S3 object referenced by an s3:// thumbnail URL', async () => {
+        const key = 'thumb-remove-test';
+        await s3.send(
+            new PutObjectCommand({
+                Bucket: BUCKET,
+                Key: key,
+                Body: Buffer.from(TINY_PNG_BASE64, 'base64'),
+                ContentType: 'image/png',
+            }),
+        );
+
+        await handleFsRemoveNodeThumbnail(
+            { target: { thumbnail: `s3://${BUCKET}/${key}` } },
+            { s3 },
+        );
+
+        // GetObject should now error because the key was deleted.
+        await expect(
+            s3.send(new GetObjectCommand({ Bucket: BUCKET, Key: key })),
+        ).rejects.toThrow();
+    });
+
+    it('is a no-op when the target has no thumbnail', async () => {
+        // Should not throw or attempt a delete.
+        await handleFsRemoveNodeThumbnail({ target: {} }, { s3 });
+    });
+
+    it('is a no-op when the thumbnail URL is not an s3:// pointer', async () => {
+        await handleFsRemoveNodeThumbnail(
+            { target: { thumbnail: 'https://cdn.example.com/x.png' } },
+            { s3 },
+        );
+    });
+});

extensions/thumbnails.ts

@@ -0,0 +1,290 @@
+import {
+    DeleteObjectCommand,
+    GetObjectCommand,
+    PutObjectCommand,
+    S3Client,
+} from '@aws-sdk/client-s3';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+import { extension } from '@heyputer/backend/src/extensions';
+import crypto from 'node:crypto';
+import sharp from 'sharp';
+const clients = extension.import('client');
+
+const MAX_THUMBNAIL_BYTES = 2 * 1024 * 1024;
+const MAX_THUMBNAIL_PIXELS = 64e6;
+
+// S3 client + bucket config — lazily resolved after boot from config.
+let s3Client: S3Client | null = null;
+let s3PresignClient: S3Client | null = null;
+let thumbnailBucketName = 'puter-local';
+let extensionBucketEndpoint = 'http://127.0.0.1:4566/puter-local/';
+
+function resolveClients(): { send: S3Client; presign: S3Client } {
+    if (s3Client && s3PresignClient) {
+        return { send: s3Client, presign: s3PresignClient };
+    }
+
+    // Top-level `thumbnailStore` config when the extension should use a
+    // dedicated S3 bucket instead of the main one.
+    const thumbStore = extension.config.thumbnailStore;
+
+    if (thumbStore?.endpoint && thumbStore.credentials) {
+        s3Client = new S3Client({
+            region: 'auto',
+            endpoint: thumbStore.endpoint,
+            credentials: thumbStore.credentials,
+        });
+        // Dedicated thumbnail buckets use a single endpoint for both
+        // server-side ops and browser-facing presigned URLs.
+        s3PresignClient = s3Client;
+        thumbnailBucketName = thumbStore.name ?? 'puter-local';
+        extensionBucketEndpoint = thumbStore.endpoint;
+    } else {
+        // Fall back to the project's S3 wrapper. `clients.s3` is the Puter
+        // `S3Client` wrapper (region-cache + lifecycle), not an AWS
+        // `S3Client`. `.get()` is for server-side ops (uses the internal
+        // `endpoint`); `.getForPresign()` is for browser-facing presigned
+        // URLs (uses `publicEndpoint` when configured — required for
+        // self-host where the docker-internal endpoint isn't reachable
+        // from the browser).
+        const wrapper = clients.s3;
+        s3Client = wrapper.get();
+        s3PresignClient = wrapper.getForPresign();
+    }
+    return { send: s3Client, presign: s3PresignClient };
+}
+
+function getClient(): S3Client {
+    return resolveClients().send;
+}
+
+function getPresignClient(): S3Client {
+    return resolveClients().presign;
+}
+
+function base64ParseDataUrl(dataURL: string) {
+    dataURL = dataURL.slice(5);
+    const mimeType = dataURL.split(';')[0];
+    const data = Buffer.from(dataURL.split(',')[1], 'base64');
+    return { mimeType, data };
+}
+
+// Strictly decode a data: URL and validate the decoded image. Encoded-string
+// length lies about decoded byte count (whitespace, padding) and says nothing
+// about pixel count — a 2MB PNG can decompress to hundreds of MB of raster.
+async function decodeAndValidateThumbnail(
+    dataURL: string,
+): Promise<{ mimeType: string; data: Buffer } | null> {
+    const commaIdx = dataURL.indexOf(',');
+    if (commaIdx === -1) return null;
+    const mimeType = dataURL.slice(5, commaIdx).split(';')[0];
+
+    const data = Buffer.from(dataURL.slice(commaIdx + 1), 'base64');
+    if (data.length === 0 || data.length > MAX_THUMBNAIL_BYTES) return null;
+
+    try {
+        await sharp(data, {
+            limitInputPixels: MAX_THUMBNAIL_PIXELS,
+            density: 72,
+            failOn: 'error',
+        }).metadata();
+    } catch {
+        return null;
+    }
+
+    return { mimeType, data };
+}
+
+// -- thumbnail.created -----------------------------------------------
+// Intercept data-URL thumbnails before they hit the DB: upload to S3
+// and replace the URL with an s3:// pointer.
+
+export async function handleThumbnailCreated(
+    event: Record<string, unknown>,
+    deps: { s3: S3Client; bucketName: string },
+): Promise<void> {
+    const url = event.url;
+    if (typeof url !== 'string' || !url.startsWith('data:')) return;
+
+    const decoded = await decodeAndValidateThumbnail(url);
+    if (!decoded) {
+        event.url = null;
+        return;
+    }
+
+    const key = crypto.randomUUID();
+    event.url = `s3://${deps.bucketName}/${key}`;
+
+    await deps.s3.send(
+        new PutObjectCommand({
+            Bucket: deps.bucketName,
+            Key: key,
+            Body: decoded.data,
+            ContentType: decoded.mimeType,
+        }),
+    );
+}
+
+export const handleThumbnailUploadPrepare = async (
+    event: Record<string, unknown>,
+    deps: { s3Presign: S3Client; bucketName: string },
+): Promise<void> => {
+    if (!event || !Array.isArray(event.items)) return;
+    const presignClient = deps.s3Presign;
+
+    for (const item of event.items as Array<Record<string, unknown>>) {
+        if (!item || typeof item !== 'object') {
+            throw new Error('thumbnail.upload.prepare item is invalid');
+        }
+
+        const contentType =
+            typeof item.contentType === 'string' ? item.contentType.trim() : '';
+        if (!contentType) continue;
+
+        if (item.size !== undefined) {
+            const size = Number(item.size);
+            if (
+                !Number.isFinite(size) ||
+                size < 0 ||
+                size > MAX_THUMBNAIL_BYTES
+            )
+                continue;
+        }
+
+        const key = crypto.randomUUID();
+        const command = new PutObjectCommand({
+            Bucket: deps.bucketName,
+            Key: key,
+            ContentType: contentType,
+        });
+        item.uploadUrl = await getSignedUrl(presignClient, command, {
+            expiresIn: 900,
+        });
+        item.thumbnailUrl = `s3://${deps.bucketName}/${key}`;
+    }
+};
+
+export const handleThumbnailRead = async (
+    entry: Record<string, unknown>,
+    deps: {
+        s3: S3Client;
+        s3Presign: S3Client;
+        bucketName: string;
+        bucketEndpoint: string;
+        db: { write: (sql: string, params: unknown[]) => Promise<unknown> };
+    },
+): Promise<void> => {
+    const thumb = entry.thumbnail;
+    if (typeof thumb !== 'string' || !thumb) return;
+    const presignClient = deps.s3Presign;
+
+    if (thumb.startsWith('s3://')) {
+        const [bucket, key] = thumb.slice(5).split('/');
+        entry.thumbnail = await getSignedUrl(
+            presignClient,
+            new GetObjectCommand({ Bucket: bucket, Key: key }),
+            { expiresIn: 604800 },
+        );
+    } else if (
+        thumb.startsWith('https') &&
+        thumb.includes(new URL(deps.bucketEndpoint).hostname)
+    ) {
+        // Legacy format — remove after full migration
+        const [bucket, key] = new URL(thumb).pathname.slice(1).split('/');
+        entry.thumbnail = await getSignedUrl(
+            presignClient,
+            new GetObjectCommand({ Bucket: bucket, Key: key }),
+            { expiresIn: 604800 },
+        );
+    } else if (thumb.startsWith('data')) {
+        // Inline data-URL migration: upload to S3 and update the DB entry.
+        const key = crypto.randomUUID();
+        const { mimeType, data } = base64ParseDataUrl(thumb);
+        const newUrl = `s3://${deps.bucketName}/${key}`;
+
+        await deps.s3.send(
+            new PutObjectCommand({
+                Bucket: deps.bucketName,
+                Key: key,
+                Body: data,
+                ContentType: mimeType,
+            }),
+        );
+
+        // Best-effort async DB update
+        const uuid = entry.uuid ?? entry.uid;
+        if (uuid) {
+            deps.db
+                .write(
+                    'UPDATE `fsentries` SET `thumbnail` = ? WHERE `uuid` = ?',
+                    [newUrl, uuid],
+                )
+                .catch((err: unknown) =>
+                    console.warn('[thumbnails] inline migration failed', err),
+                );
+        }
+
+        entry.thumbnail = await getSignedUrl(
+            presignClient,
+            new GetObjectCommand({ Bucket: deps.bucketName, Key: key }),
+            { expiresIn: 604800 },
+        );
+    }
+};
+
+export const handleFsRemoveNodeThumbnail = async (
+    payload: { target: Record<string, unknown> },
+    deps: { s3: S3Client },
+): Promise<void> => {
+    const thumbnailUrl = payload.target.thumbnail as string | undefined;
+    if (!thumbnailUrl || !thumbnailUrl.startsWith('s3://')) return;
+
+    const [bucket, key] = thumbnailUrl.slice(5).split('/');
+    await deps.s3.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }));
+};
+
+extension.on(
+    'thumbnail.created',
+    async (_key, event: Record<string, unknown>) => {
+        await handleThumbnailCreated(event, {
+            s3: getClient(),
+            bucketName: thumbnailBucketName,
+        });
+    },
+);
+
+// -- thumbnail.upload.prepare ----------------------------------------
+// Generate pre-signed upload URLs so the client can PUT directly to S3.
+
+extension.on(
+    'thumbnail.upload.prepare',
+    async (_key, event: Record<string, unknown>) => {
+        await handleThumbnailUploadPrepare(event, {
+            s3Presign: getPresignClient(),
+            bucketName: thumbnailBucketName,
+        });
+    },
+);
+
+// -- thumbnail.read --------------------------------------------------
+// Convert s3:// or legacy https:// thumbnails to signed URLs.
+
+extension.on('thumbnail.read', async (_key, entry: Record<string, unknown>) => {
+    await handleThumbnailRead(entry, {
+        s3: getClient(),
+        s3Presign: getPresignClient(),
+        bucketName: thumbnailBucketName,
+        bucketEndpoint: extensionBucketEndpoint,
+        db: clients.db,
+    });
+});
+
+// -- fs.remove.node --------------------------------------------------
+// Delete S3 thumbnail when the file is removed.
+
+extension.on(
+    'fs.remove.node',
+    async (_key, payload: { target: Record<string, unknown> }) => {
+        await handleFsRemoveNodeThumbnail(payload, { s3: getClient() });
+    },
+);

extensions/whoami.test.ts

@@ -0,0 +1,184 @@
+import type { Request, Response } from 'express';
+import { v4 as uuidv4 } from 'uuid';
+import {
+    afterAll,
+    beforeAll,
+    describe,
+    expect,
+    it,
+    vi,
+} from 'vitest';
+import { runWithContext } from '../src/backend/core/context.ts';
+import { PuterServer } from '../src/backend/server.ts';
+import { setupTestServer } from '../src/backend/testUtil.ts';
+import { handleWhoami } from './whoami.ts';
+
+interface CapturedResponse {
+    statusCode: number;
+    body: unknown;
+}
+
+const makeReq = (query: Record<string, unknown> = {}): Request =>
+    ({ query }) as unknown as Request;
+
+const makeRes = () => {
+    const captured: CapturedResponse = { statusCode: 200, body: undefined };
+    const res = {
+        json: vi.fn((value: unknown) => {
+            captured.body = value;
+            return res;
+        }),
+        status: vi.fn((code: number) => {
+            captured.statusCode = code;
+            return res;
+        }),
+    };
+    return { res: res as unknown as Response, captured };
+};
+
+let server: PuterServer;
+
+beforeAll(async () => {
+    server = await setupTestServer({
+        // Feature flag allowlist is enforced in the handler. We seed
+        // both an allow-listed flag and an internal flag to verify the
+        // internal one never reaches the response.
+        feature_flags: {
+            create_shortcut: true,
+            payment_bypass: true,
+        },
+    } as never);
+});
+
+afterAll(async () => {
+    await server.shutdown();
+});
+
+const seedUser = async () => {
+    const slug = Math.random().toString(36).slice(2, 8);
+    return server.stores.user.create({
+        username: `wuser_${slug}`,
+        uuid: uuidv4(),
+        password: 'hashedpw',
+        email: `${slug}@example.com`,
+    });
+};
+
+describe('whoami extension — handleWhoami', () => {
+    it('returns 401 when no actor is on the context', async () => {
+        const { res, captured } = makeRes();
+
+        await runWithContext({ actor: undefined }, () =>
+            handleWhoami(makeReq(), res),
+        );
+
+        expect(captured.statusCode).toBe(401);
+        expect(captured.body).toEqual({ error: 'Authentication required' });
+    });
+
+    it('returns 404 when the actor’s user no longer exists', async () => {
+        const { res, captured } = makeRes();
+
+        await runWithContext(
+            {
+                actor: {
+                    user: { uuid: 'ghost-uuid', id: 99_999_999 },
+                },
+            },
+            () => handleWhoami(makeReq(), res),
+        );
+
+        expect(captured.statusCode).toBe(404);
+        expect(captured.body).toEqual({ error: 'User not found' });
+    });
+
+    it('returns full user details for a user actor', async () => {
+        const user = await seedUser();
+        const { res, captured } = makeRes();
+
+        await runWithContext(
+            { actor: { user: { uuid: user.uuid, id: user.id as number } } },
+            () => handleWhoami(makeReq(), res),
+        );
+
+        const body = captured.body as Record<string, unknown>;
+        expect(body.username).toBe(user.username);
+        expect(body.uuid).toBe(user.uuid);
+        expect(body.email).toBe(user.email);
+        expect(body.is_temp).toBe(false);
+        expect(body.oidc_only).toBe(false);
+        // `directories` is only sent to user actors — confirm it’s present.
+        expect(body.directories).toBeDefined();
+        // taskbar_items is only sent to user actors.
+        expect(body).toHaveProperty('taskbar_items');
+    });
+
+    it('only forwards allow-listed feature flags', async () => {
+        const user = await seedUser();
+        const { res, captured } = makeRes();
+
+        await runWithContext(
+            { actor: { user: { uuid: user.uuid, id: user.id as number } } },
+            () => handleWhoami(makeReq(), res),
+        );
+
+        const flags = (captured.body as Record<string, unknown>)
+            .feature_flags as Record<string, boolean>;
+        // Allowed flag is forwarded as a coerced boolean.
+        expect(flags.create_shortcut).toBe(true);
+        // Internal flag must never leak.
+        expect(flags.payment_bypass).toBeUndefined();
+    });
+
+    it('strips desktop_bg_* and human_readable_age fields for app actors', async () => {
+        const user = await seedUser();
+        const { res, captured } = makeRes();
+
+        await runWithContext(
+            {
+                actor: {
+                    user: { uuid: user.uuid, id: user.id as number },
+                    app: { uid: 'app-test-actor' },
+                },
+            },
+            () => handleWhoami(makeReq(), res),
+        );
+
+        const body = captured.body as Record<string, unknown>;
+        expect(body.app_name).toBe('app-test-actor');
+        expect(body.desktop_bg_url).toBeUndefined();
+        expect(body.desktop_bg_color).toBeUndefined();
+        expect(body.desktop_bg_fit).toBeUndefined();
+        expect(body.human_readable_age).toBeUndefined();
+        // Directories are user-only.
+        expect(body.directories).toBeUndefined();
+    });
+
+    it('marks the user as oidc_only when password is null', async () => {
+        const slug = Math.random().toString(36).slice(2, 8);
+        const oidcUser = await server.stores.user.create({
+            username: `oidc_${slug}`,
+            uuid: uuidv4(),
+            password: null,
+            email: `${slug}@oidc.test`,
+        });
+
+        const { res, captured } = makeRes();
+        await runWithContext(
+            {
+                actor: {
+                    user: {
+                        uuid: oidcUser.uuid,
+                        id: oidcUser.id as number,
+                    },
+                },
+            },
+            () => handleWhoami(makeReq(), res),
+        );
+
+        const body = captured.body as Record<string, unknown>;
+        expect(body.oidc_only).toBe(true);
+        // No email yet means temp account.
+        expect(body.is_temp).toBe(false);
+    });
+});

extensions/whoami.ts

@@ -0,0 +1,192 @@
+import { Context } from '@heyputer/backend/src/core';
+import { extension } from '@heyputer/backend/src/extensions';
+import { getTaskbarItems } from '@heyputer/backend/src/util/taskbarItems.js';
+import type { Request, Response } from 'express';
+import TimeAgo from 'javascript-time-ago';
+import localeEn from 'javascript-time-ago/locale/en';
+
+const stores = extension.import('store');
+const services = extension.import('service');
+const clients = extension.import('client');
+
+const timeago = (() => {
+    TimeAgo.addDefaultLocale(localeEn);
+    return new TimeAgo('en-US');
+})();
+
+// Allowlist of `config.feature_flags` keys safe to surface via /whoami.
+// Anything not listed here stays server-side, so internal flags
+// (payment_bypass, staff_only_*, etc.) cannot leak by accident. Add a
+// flag here when, and only when, the client actually needs to read it.
+const CLIENT_VISIBLE_FEATURE_FLAGS: ReadonlySet<string> = new Set([
+    'create_shortcut',
+    'download_directory',
+    'prompt_user_when_navigation_away_from_puter',
+]);
+
+export const handleWhoami = async (
+    req: Request,
+    res: Response,
+): Promise<void> => {
+    const actor = Context.get('actor');
+    if (!actor?.user?.id) {
+        res.status(401).json({ error: 'Authentication required' });
+        return;
+    }
+
+    const isUser = !actor.app;
+    const user = await stores.user.getById(actor.user.id);
+    if (!user) {
+        res.status(404).json({ error: 'User not found' });
+        return;
+    }
+
+    const oidcOnly = user.password === null;
+    const ALLOWED_ICON_SIZES = new Set([16, 32, 64, 128, 256, 512]);
+    const rawIconSize =
+        typeof req.query?.icon_size === 'string'
+            ? Number(req.query.icon_size)
+            : undefined;
+    const iconSize =
+        rawIconSize !== undefined && ALLOWED_ICON_SIZES.has(rawIconSize)
+            ? rawIconSize
+            : undefined;
+    const noIcons = !iconSize;
+
+    // Feature flags come from `config.feature_flags`. We only forward keys
+    // listed in CLIENT_VISIBLE_FEATURE_FLAGS so internal flags can't leak.
+    // Non-boolean values (e.g. `"true"` as a string) are coerced so the
+    // client never has to guess.
+    const rawFlags = extension.config.feature_flags ?? {};
+    const feature_flags: Record<string, boolean> = {};
+    for (const [k, v] of Object.entries(rawFlags)) {
+        if (CLIENT_VISIBLE_FEATURE_FLAGS.has(k)) {
+            feature_flags[k] = Boolean(v);
+        }
+    }
+
+    const details: Record<string, unknown> = {
+        username: user.username,
+        uuid: user.uuid,
+        email: user.email,
+        unconfirmed_email: user.email,
+        email_confirmed: user.email_confirmed || user.username === 'admin',
+        requires_email_confirmation: user.requires_email_confirmation,
+        desktop_bg_url: user.desktop_bg_url,
+        desktop_bg_color: user.desktop_bg_color,
+        desktop_bg_fit: user.desktop_bg_fit,
+        is_temp: user.password === null && user.email === null,
+        oidc_only: oidcOnly,
+        taskbar_items: isUser
+            ? await getTaskbarItems(
+                  user,
+                  {
+                      clients,
+                      stores,
+                      services,
+                      apiBaseUrl: String(extension.config.api_base_url ?? ''),
+                  },
+                  { iconSize, noIcons },
+              )
+            : undefined,
+        otp: !!user.otp_enabled,
+        feature_flags,
+        human_readable_age: user.timestamp
+            ? timeago.format(new Date(user.timestamp as string))
+            : null,
+        metadata: user.metadata,
+        hasDevAccountAccess: !!user.metadata?.hasDevAccountAccess,
+    };
+
+    // OIDC revalidate URL for password-less accounts
+    if (oidcOnly) {
+        try {
+            const provider = await services.oidc.getLinkedProviderForUser(
+                user.id as number,
+            );
+            if (provider) {
+                const origin = (extension.config.origin ?? '').replace(
+                    /\/$/,
+                    '',
+                );
+                details.oidc_revalidate_url = `${origin}/auth/oidc/${provider}/start?flow=revalidate&user_uuid=${encodeURIComponent(user.uuid)}`;
+            }
+        } catch {
+            // OIDC not configured
+        }
+    }
+
+    // Directories — only sent to user actors
+    if (isUser) {
+        const directories: Record<string, unknown> = {};
+        const nameToProp: Record<string, string> = {
+            desktop_uuid: `/${user.username}/Desktop`,
+            appdata_uuid: `/${user.username}/AppData`,
+            documents_uuid: `/${user.username}/Documents`,
+            pictures_uuid: `/${user.username}/Pictures`,
+            videos_uuid: `/${user.username}/Videos`,
+            trash_uuid: `/${user.username}/Trash`,
+        };
+        for (const k in nameToProp) {
+            directories[nameToProp[k]] = user[k];
+        }
+        details.directories = directories;
+    }
+
+    // Last activity
+    if (user.last_activity_ts) {
+        try {
+            details.last_activity_ts = Math.round(
+                new Date(user.last_activity_ts as string).getTime() / 1000,
+            );
+        } catch {
+            /* ignore parse error */
+        }
+    }
+
+    // Strip sensitive fields for app actors
+    if (!isUser) {
+        const canReadEmail = await services.permission
+            .check(actor, `user:${user.uuid}:email:read`)
+            .catch(() => false);
+        if (!canReadEmail) {
+            delete details.email;
+            delete details.unconfirmed_email;
+        }
+        delete details.desktop_bg_url;
+        delete details.desktop_bg_color;
+        delete details.desktop_bg_fit;
+        delete details.human_readable_age;
+    }
+
+    if (actor.app) {
+        details.app_name = actor.app.uid;
+    }
+
+    try {
+        await clients.event.emitAndWait(
+            'whoami.details',
+            { user, details, isUser },
+            {},
+        );
+    } catch {
+        /* best-effort */
+    }
+
+    const subscription = details.subscription as
+        | { offering?: Record<string, unknown> }
+        | undefined;
+    if (subscription?.offering) {
+        delete subscription.offering.group;
+        delete subscription.offering.benefits;
+        delete subscription.offering.price_id;
+    }
+
+    res.json(details);
+};
+
+extension.get(
+    '/whoami',
+    { subdomain: 'api', requireAuth: true, allowUnconfirmed: true },
+    handleWhoami,
+);

extensions/workerSandbox.test.ts

@@ -0,0 +1,41 @@
+import type { Request, Response } from 'express';
+import { describe, expect, it, vi } from 'vitest';
+import { handleWorkerSandboxPage } from './workerSandbox.ts';
+
+interface CapturedResponse {
+    contentType: string | undefined;
+    body: string | undefined;
+}
+
+const makeRes = () => {
+    const captured: CapturedResponse = {
+        contentType: undefined,
+        body: undefined,
+    };
+    const res = {
+        type: vi.fn((mime: string) => {
+            captured.contentType = mime;
+            return res;
+        }),
+        send: vi.fn((value: string) => {
+            captured.body = value;
+            return res;
+        }),
+    };
+    return { res: res as unknown as Response, captured };
+};
+
+describe('workerSandbox extension — handleWorkerSandboxPage', () => {
+    it('sends the playground HTML page with text/html content type', () => {
+        const { res, captured } = makeRes();
+
+        handleWorkerSandboxPage({} as Request, res);
+
+        expect(captured.contentType).toBe('html');
+        expect(typeof captured.body).toBe('string');
+        expect(captured.body).toContain('<!doctype html>');
+        expect(captured.body).toContain('Puter Worker Sandbox Playground');
+        // The page is meant to load the public puter SDK
+        expect(captured.body).toContain('https://js.puter.com/v2/');
+    });
+});

extensions/workerSandbox.ts

@@ -0,0 +1,101 @@
+import type { Request, Response } from 'express';
+import { extension } from '@heyputer/backend/src/extensions';
+
+const page = `
+<!doctype html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Puter Worker Sandbox Playground</title>
+    <style>
+        :root {
+            color-scheme: light;
+            --bg: #0f172a;
+            --panel: #111827;
+            --panel-2: #1f2937;
+            --text: #e5e7eb;
+            --muted: #94a3b8;
+            --accent: #22d3ee;
+            --danger: #fb7185;
+            --ok: #34d399;
+            --border: #334155;
+        }
+        * { box-sizing: border-box; }
+        body {
+            margin: 0;
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+            background: radial-gradient(circle at top, #1e293b, var(--bg) 55%);
+            color: var(--text);
+            min-height: 100vh;
+            padding: 20px;
+        }
+        .wrap { max-width: 980px; margin: 0 auto; }
+        h1 { margin: 0 0 8px; font-size: 24px; }
+        p { margin: 0 0 14px; color: var(--muted); }
+        .toolbar { display: flex; gap: 10px; margin-bottom: 10px; flex-wrap: wrap; }
+        button { border: 1px solid var(--border); background: var(--panel-2); color: var(--text); padding: 8px 12px; border-radius: 8px; cursor: pointer; }
+        button:hover { border-color: var(--accent); }
+        .layout { display: grid; gap: 12px; grid-template-columns: 1fr; }
+        @media (min-width: 900px) { .layout { grid-template-columns: 1fr 1fr; } }
+        .card { border: 1px solid var(--border); border-radius: 10px; background: color-mix(in srgb, var(--panel) 88%, black 12%); overflow: hidden; }
+        .card h2 { margin: 0; padding: 10px 12px; font-size: 14px; border-bottom: 1px solid var(--border); background: color-mix(in srgb, var(--panel-2) 90%, black 10%); }
+        textarea { display: block; width: 100%; min-height: 420px; border: 0; resize: vertical; background: transparent; color: var(--text); padding: 12px; outline: none; font-size: 13px; line-height: 1.5; }
+        #logs { margin: 0; padding: 12px; min-height: 420px; max-height: 70vh; overflow: auto; white-space: pre-wrap; word-break: break-word; font-size: 13px; line-height: 1.45; }
+        .line { margin: 0 0 8px; }
+        .info { color: var(--muted); }
+        .ok { color: var(--ok); }
+        .warn { color: #fbbf24; }
+        .error { color: var(--danger); }
+        code { color: var(--accent); }
+    </style>
+</head>
+<body>
+    <main class="wrap">
+        <h1>Puter Worker Sandbox Playground</h1>
+        <p>Use this page to interact with the puter APIs in the same sandbox as your worker.</p>
+        <div class="toolbar">
+            <button id="run">Run</button>
+            <button id="clear">Clear Logs</button>
+        </div>
+        <section class="layout">
+            <article class="card">
+                <h2>Code</h2>
+                <textarea id="code" spellcheck="false">console.log(JSON.stringify(await puter.kv.list({limit: 100})))</textarea>
+            </article>
+            <article class="card">
+                <h2>Logs</h2>
+                <pre id="logs"></pre>
+            </article>
+        </section>
+    </main>
+    <script src="https://js.puter.com/v2/"></script>
+    <script>
+        (() => {
+            const codeEl = document.getElementById('code');
+            const logsEl = document.getElementById('logs');
+            const runBtn = document.getElementById('run');
+            const clearBtn = document.getElementById('clear');
+            const originalConsole = { log: console.log.bind(console), info: console.info.bind(console), warn: console.warn.bind(console), error: console.error.bind(console) };
+            const safeStringify = (v) => { if (typeof v === 'string') return v; if (v instanceof Error) return v.stack || v.message || String(v); try { return JSON.stringify(v, null, 2); } catch { return String(v); } };
+            const appendLog = (level, parts) => { const line = document.createElement('div'); line.className = 'line ' + level; line.textContent = '[' + new Date().toLocaleTimeString() + '] ' + parts.map(safeStringify).join(' '); logsEl.appendChild(line); logsEl.scrollTop = logsEl.scrollHeight; };
+            ['log', 'info', 'warn', 'error'].forEach((level) => { console[level] = (...args) => { appendLog(level === 'log' ? 'ok' : level, args); originalConsole[level](...args); }; });
+            window.addEventListener('error', (event) => { appendLog('error', [event.error || event.message]); });
+            const AsyncFunction = Object.getPrototypeOf(async function () {}).constructor;
+            runBtn.addEventListener('click', async () => { const source = codeEl.value; appendLog('info', ['Running...']); try { const fn = new AsyncFunction(source); const result = await fn.call(window); appendLog('ok', ['Result:', result]); } catch (err) { appendLog('error', ['Execution failed:', err]); } });
+            clearBtn.addEventListener('click', () => { logsEl.textContent = ''; });
+        })();
+    </script>
+</body>
+</html>
+`;
+
+export const handleWorkerSandboxPage = (_req: Request, res: Response): void => {
+    res.type('html').send(page);
+};
+
+extension.get(
+    '/',
+    { requireAuth: false, subdomain: 'worker-sandbox' },
+    handleWorkerSandboxPage,
+);

incubator/x86emu/README.md

@@ -1,17 +0,0 @@
-# Research + Planning for x86 Emulation in Puter
-
-## Resources
-- [copy.sh/v86 docs](https://github.com/copy/v86/blob/master/docs)
-- [greenfield github](https://github.com/udevbe/greenfield)
-
-## TODO
-
-### Documents to Write
-
-- [ ] specification for Puter network driver
-- [ ] specification for Puter network relay
-
-### Things to Try
-
-- [ ] greenfield/wayland/arch/v86
-- [ ] puter-fuse in v86

install.ps1

@@ -0,0 +1,208 @@
+#!/usr/bin/env pwsh
+# Self-hosted Puter — one-shot installer (PowerShell port of install.sh).
+#
+# Usage (interactive):
+#   .\install.ps1
+#
+# Usage (one-liner, like curl|sh):
+#   irm https://raw.githubusercontent.com/HeyPuter/puter/main/install.ps1 | iex
+#   (when piped through iex, params can't be passed; use env vars below)
+#
+# What this does, in order:
+#   1. Checks that docker (with the compose plugin) exists.
+#   2. Creates ./puter-selfhosted/ (override with $env:PUTER_DIR).
+#   3. Downloads docker-compose.yml + nginx.conf from the OSS repo.
+#   4. Generates fresh secrets and writes .env + puter/config/config.json.
+#   5. Runs `docker compose up -d` and prints how to find the admin password.
+#
+# Re-running in an already-initialised directory is a no-op for config
+# (it won't clobber existing .env / config.json) and just refreshes the
+# compose file + brings the stack up. Set PUTER_FORCE=1 to overwrite.
+#
+# Tunable env vars (or pass as -Parameters when running the file directly):
+#   PUTER_DIR     install directory                       (default: ./puter-selfhosted)
+#   PUTER_URL     base URL to fetch docker-compose.yml    (default: GitHub raw, main branch)
+#   PUTER_DOMAIN  domain Puter will serve on              (default: puter.localhost)
+#   PUTER_PORT    HTTP port for nginx                     (default: 80)
+#   PUTER_FORCE   set to 1 to overwrite existing .env / config.json
+
+[CmdletBinding()]
+param(
+    [string]$PuterDir    = $(if ($env:PUTER_DIR)    { $env:PUTER_DIR }         else { 'puter-selfhosted' }),
+    [string]$PuterUrl    = $(if ($env:PUTER_URL)    { $env:PUTER_URL }         else { 'https://raw.githubusercontent.com/HeyPuter/puter/main' }),
+    [string]$PuterDomain = $(if ($env:PUTER_DOMAIN) { $env:PUTER_DOMAIN }      else { 'puter.localhost' }),
+    [int]   $PuterPort   = $(if ($env:PUTER_PORT)   { [int]$env:PUTER_PORT }   else { 80 }),
+    [switch]$Force       = $($env:PUTER_FORCE -eq '1')
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Write-Log  { param($Msg) Write-Host "[puter-install] $Msg" -ForegroundColor Cyan }
+function Write-Warn { param($Msg) Write-Host "[puter-install] $Msg" -ForegroundColor Yellow }
+function Die        { param($Msg) Write-Host "[puter-install] $Msg" -ForegroundColor Red; exit 1 }
+
+function Test-Command {
+    param([string]$Name)
+    if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
+        Die "missing required command: $Name"
+    }
+}
+
+function New-HexSecret {
+    param([int]$Bytes)
+    $buf = New-Object byte[] $Bytes
+    $rng = [System.Security.Cryptography.RandomNumberGenerator]::Create()
+    try { $rng.GetBytes($buf) } finally { $rng.Dispose() }
+    # BitConverter is portable across PS 5.1 and 7+ (ToHexString is 7+ only).
+    return [System.BitConverter]::ToString($buf).Replace('-', '').ToLowerInvariant()
+}
+
+function Write-Utf8NoBomLF {
+    param([string]$Path, [string]$Content)
+    $full = if ([System.IO.Path]::IsPathRooted($Path)) { $Path } else { Join-Path (Get-Location) $Path }
+    $lf   = $Content -replace "`r`n", "`n"
+    [System.IO.File]::WriteAllText($full, $lf, (New-Object System.Text.UTF8Encoding $false))
+}
+
+# ── Step 1: dependency check ────────────────────────────────────────
+Write-Log 'checking dependencies'
+Test-Command docker
+# curl + openssl aren't required on Windows; PowerShell + .NET cover both.
+
+$null = & docker compose version 2>&1
+if ($LASTEXITCODE -ne 0) {
+    Die "docker compose plugin not found — install Docker Desktop (or enable the v2 compose plugin)"
+}
+
+# ── Step 2: install dir ─────────────────────────────────────────────
+$null = New-Item -ItemType Directory -Force -Path $PuterDir
+Set-Location $PuterDir
+$null = New-Item -ItemType Directory -Force -Path 'puter/config', 'puter/data', 'puter/tls'
+Write-Log "install dir: $((Get-Location).Path)"
+
+# ── Step 3: docker-compose.yml + nginx config ──────────────────────
+Write-Log "downloading docker-compose.yml from $PuterUrl"
+try {
+    Invoke-WebRequest -Uri "$PuterUrl/docker-compose.yml" -OutFile 'docker-compose.yml' -UseBasicParsing
+} catch {
+    Die "could not fetch $PuterUrl/docker-compose.yml — $_"
+}
+
+Write-Log "downloading nginx/nginx.conf from $PuterUrl"
+$null = New-Item -ItemType Directory -Force -Path 'nginx'
+# If the path was previously auto-created as a directory by a failed
+# `compose up`, remove it so we can write the file there.
+if (Test-Path 'nginx/nginx.conf' -PathType Container) {
+    Remove-Item 'nginx/nginx.conf' -Recurse -Force
+}
+try {
+    Invoke-WebRequest -Uri "$PuterUrl/nginx/nginx.conf" -OutFile 'nginx/nginx.conf' -UseBasicParsing
+} catch {
+    Die "could not fetch $PuterUrl/nginx/nginx.conf — $_"
+}
+
+# ── Step 4: secrets, .env, config.json ──────────────────────────────
+$writeConfig = $true
+if ((Test-Path '.env') -and (Test-Path 'puter/config/config.json') -and -not $Force) {
+    Write-Log ".env + config.json already present — keeping existing secrets (PUTER_FORCE=1 or -Force to overwrite)"
+    $writeConfig = $false
+}
+
+if ($writeConfig) {
+    Write-Log 'generating secrets'
+    $mariadbRootPw = New-HexSecret 32
+    $mariadbPw     = New-HexSecret 32
+    $s3SecretKey   = New-HexSecret 32
+    # Two JWT secrets: $jwtSecret is verify-only for legacy v1 tokens
+    # already in circulation; $jwtSecretV2 signs every new token.
+    $jwtSecret     = New-HexSecret 64
+    $jwtSecretV2   = New-HexSecret 64
+    $urlSigSecret  = New-HexSecret 64
+
+    $envContent = @"
+HTTP_PORT=$PuterPort
+# HTTPS_PORT=443     # uncomment after enabling TLS (see doc/selfhosting/full-stack.md)
+
+MARIADB_ROOT_PASSWORD=$mariadbRootPw
+MARIADB_DATABASE=puter
+MARIADB_USER=puter
+MARIADB_PASSWORD=$mariadbPw
+
+S3_ACCESS_KEY=puter
+S3_SECRET_KEY=$s3SecretKey
+S3_BUCKET=puter-local
+"@
+    Write-Utf8NoBomLF -Path '.env' -Content $envContent
+
+    Write-Log 'writing puter/config/config.json'
+    $config = [ordered]@{
+        domain                         = $PuterDomain
+        protocol                       = 'http'
+        pub_port                       = $PuterPort
+        env                            = 'prod'
+        static_hosting_domain          = "site.$PuterDomain"
+        static_hosting_domain_alt      = "host.$PuterDomain"
+        private_app_hosting_domain     = "app.$PuterDomain"
+        private_app_hosting_domain_alt = "dev.$PuterDomain"
+        jwt_secret                     = $jwtSecret
+        jwt_secret_v2                  = $jwtSecretV2
+        allow_v1_tokens                = $true
+        url_signature_secret           = $urlSigSecret
+        database = [ordered]@{
+            engine         = 'mysql'
+            host           = 'mariadb'
+            port           = 3306
+            user           = 'puter'
+            password       = $mariadbPw
+            database       = 'puter'
+            migrationPaths = @('/opt/puter/dist/src/backend/clients/database/migrations/mysql')
+        }
+        redis = [ordered]@{
+            startupNodes = @(
+                [ordered]@{ host = 'valkey'; port = 6379 }
+            )
+            tls = $false
+        }
+        dynamo = [ordered]@{
+            endpoint        = 'http://dynamo:8000'
+            bootstrapTables = $true
+            aws = [ordered]@{
+                access_key = 'fake'
+                secret_key = 'fake'
+                region     = 'us-east-1'
+            }
+        }
+        s3 = [ordered]@{
+            s3Config = [ordered]@{
+                endpoint        = 'http://s3:9000'
+                publicEndpoint  = "http://s3.$PuterDomain"
+                accessKeyId     = 'puter'
+                secretAccessKey = $s3SecretKey
+                region          = 'us-east-1'
+                forcePathStyle  = $true
+            }
+        }
+        s3_bucket = 'puter-local'
+        s3_region = 'us-east-1'
+        providers = [ordered]@{
+            ollama = [ordered]@{ enabled = $false }
+        }
+        trust_proxy = 1
+    }
+    $configJson = $config | ConvertTo-Json -Depth 10
+    Write-Utf8NoBomLF -Path 'puter/config/config.json' -Content $configJson
+}
+
+# ── Step 5: bring it up ─────────────────────────────────────────────
+Write-Log 'docker compose up -d'
+& docker compose up -d
+if ($LASTEXITCODE -ne 0) { Die 'docker compose up failed' }
+
+Write-Log ''
+Write-Log 'stack starting. first boot takes ~30s while MariaDB initialises.'
+Write-Log 'follow puter logs:'
+Write-Log "    cd $PuterDir; docker compose logs -f puter"
+Write-Log ''
+Write-Log "open http://${PuterDomain}:${PuterPort} once the puter container is healthy."
+Write-Log 'first-boot admin password is logged once — grab it with:'
+Write-Log "    cd $PuterDir; docker compose logs puter | Select-String password"

install.sh

@@ -0,0 +1,192 @@
+#!/usr/bin/env sh
+# Self-hosted Puter — one-shot installer.
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/HeyPuter/puter/main/install.sh | sh
+#
+# What this does, in order:
+#   1. Checks that docker (with the compose plugin), curl, and openssl exist.
+#   2. Creates ./puter-selfhosted/ (override with PUTER_DIR=...).
+#   3. Downloads docker-compose.yml from the OSS repo (raw.githubusercontent.com).
+#   4. Generates fresh secrets and writes .env + puter/config/config.json.
+#   5. Runs `docker compose up -d` and prints the first-boot admin password.
+#
+# Re-running the script in an already-initialised directory is a no-op for
+# config (it won't clobber existing .env / config.json) and just refreshes
+# the compose file + brings the stack up. Set PUTER_FORCE=1 to overwrite.
+#
+# Tunable env vars:
+#   PUTER_DIR     install directory                       (default: ./puter-selfhosted)
+#   PUTER_URL     base URL to fetch docker-compose.yml    (default: GitHub raw, main branch)
+#   PUTER_DOMAIN  domain Puter will serve on              (default: puter.localhost)
+#   PUTER_PORT    HTTP port for nginx                     (default: 80)
+#   PUTER_FORCE   set to 1 to overwrite existing .env / config.json
+
+set -eu
+
+PUTER_DIR="${PUTER_DIR:-puter-selfhosted}"
+PUTER_URL="${PUTER_URL:-https://raw.githubusercontent.com/HeyPuter/puter/main}"
+PUTER_DOMAIN="${PUTER_DOMAIN:-puter.localhost}"
+PUTER_PORT="${PUTER_PORT:-80}"
+PUTER_FORCE="${PUTER_FORCE:-0}"
+
+log()  { printf '\033[1;36m[puter-install]\033[0m %s\n' "$*"; }
+warn() { printf '\033[1;33m[puter-install]\033[0m %s\n' "$*" >&2; }
+die()  { printf '\033[1;31m[puter-install]\033[0m %s\n' "$*" >&2; exit 1; }
+
+need() {
+    command -v "$1" >/dev/null 2>&1 || die "missing required command: $1"
+}
+
+# ── Step 1: dependency check ────────────────────────────────────────
+log "checking dependencies"
+need docker
+need curl
+need openssl
+docker compose version >/dev/null 2>&1 \
+    || die "docker compose plugin not found — install docker desktop or 'docker-compose-plugin'"
+
+# ── Step 2: install dir ─────────────────────────────────────────────
+mkdir -p "$PUTER_DIR"
+cd "$PUTER_DIR"
+mkdir -p puter/config puter/data puter/tls
+# Pre-create per-service data dirs and make them writable by any UID.
+# Several upstream images run as non-root inside the container (rustfs
+# uses UID 10001; dynamo is pinned to 1000 in compose), and rustfs's
+# entrypoint runs as that same non-root user so it can't chown an
+# already-existing bind-mounted dir. On hosts where the user that ran
+# this script has a UID that doesn't match — or where docker is running
+# rootless — those containers loop on EACCES at startup. 0777 on the
+# bind-mount roots sidesteps the mismatch without guessing each image's
+# internal UID. (Docker Desktop on macOS/Windows papers over this with
+# its VM layer; native Linux docker on Debian/Alpine doesn't.)
+mkdir -p puter/data/valkey puter/data/mariadb puter/data/dynamo puter/data/s3 puter/data/puter
+chmod 0777 puter/data/valkey puter/data/mariadb puter/data/dynamo puter/data/s3 puter/data/puter
+log "install dir: $(pwd)"
+
+# ── Step 3: docker-compose.yml + nginx config ──────────────────────
+log "downloading docker-compose.yml from $PUTER_URL"
+curl -fsSL "$PUTER_URL/docker-compose.yml" -o docker-compose.yml \
+    || die "could not fetch $PUTER_URL/docker-compose.yml"
+
+# nginx is mounted as `./nginx/nginx.conf:/etc/nginx/nginx.conf:ro` — if
+# the host file is missing, docker silently creates a directory at that
+# path and the mount fails with "not a directory" at container start.
+log "downloading nginx/nginx.conf from $PUTER_URL"
+mkdir -p nginx
+# If the path was previously auto-created as a dir by a failed `compose up`,
+# remove it so curl can write the file.
+[ -d nginx/nginx.conf ] && rmdir nginx/nginx.conf 2>/dev/null || true
+curl -fsSL "$PUTER_URL/nginx/nginx.conf" -o nginx/nginx.conf \
+    || die "could not fetch $PUTER_URL/nginx/nginx.conf"
+
+# ── Step 4: secrets, .env, config.json ──────────────────────────────
+write_config=1
+if [ -f .env ] && [ -f puter/config/config.json ] && [ "$PUTER_FORCE" != "1" ]; then
+    log ".env + config.json already present — keeping existing secrets (PUTER_FORCE=1 to overwrite)"
+    write_config=0
+fi
+
+if [ "$write_config" = "1" ]; then
+    log "generating secrets"
+    MARIADB_ROOT_PASSWORD=$(openssl rand -hex 32)
+    MARIADB_PASSWORD=$(openssl rand -hex 32)
+    S3_SECRET_KEY=$(openssl rand -hex 32)
+    # Two JWT secrets: `jwt_secret` is verify-only for legacy v1 tokens
+    # already in circulation; `jwt_secret_v2` signs every new token.
+    # Both are required at boot (`jwt_secret` only when verifying v1).
+    JWT_SECRET=$(openssl rand -hex 64)
+    JWT_SECRET_V2=$(openssl rand -hex 64)
+    URL_SIGNATURE_SECRET=$(openssl rand -hex 64)
+
+    cat > .env <<EOF
+HTTP_PORT=$PUTER_PORT
+# HTTPS_PORT=443     # uncomment after enabling TLS (see doc/selfhosting/full-stack.md)
+
+MARIADB_ROOT_PASSWORD=$MARIADB_ROOT_PASSWORD
+MARIADB_DATABASE=puter
+MARIADB_USER=puter
+MARIADB_PASSWORD=$MARIADB_PASSWORD
+
+S3_ACCESS_KEY=puter
+S3_SECRET_KEY=$S3_SECRET_KEY
+S3_BUCKET=puter-local
+EOF
+
+    log "writing puter/config/config.json"
+    cat > puter/config/config.json <<EOF
+{
+    "domain": "$PUTER_DOMAIN",
+    "protocol": "http",
+    "pub_port": $PUTER_PORT,
+    "env": "prod",
+
+    "static_hosting_domain": "site.$PUTER_DOMAIN",
+    "static_hosting_domain_alt": "host.$PUTER_DOMAIN",
+    "private_app_hosting_domain": "app.$PUTER_DOMAIN",
+    "private_app_hosting_domain_alt": "dev.$PUTER_DOMAIN",
+
+    "jwt_secret": "$JWT_SECRET",
+    "jwt_secret_v2": "$JWT_SECRET_V2",
+    "allow_v1_tokens": true,
+    "url_signature_secret": "$URL_SIGNATURE_SECRET",
+
+    "database": {
+        "engine": "mysql",
+        "host": "mariadb",
+        "port": 3306,
+        "user": "puter",
+        "password": "$MARIADB_PASSWORD",
+        "database": "puter",
+        "migrationPaths": ["/opt/puter/dist/src/backend/clients/database/migrations/mysql"]
+    },
+
+    "redis": {
+        "startupNodes": [{ "host": "valkey", "port": 6379 }],
+        "tls": false
+    },
+
+    "dynamo": {
+        "endpoint": "http://dynamo:8000",
+        "bootstrapTables": true,
+        "aws": {
+            "access_key": "fake",
+            "secret_key": "fake",
+            "region": "us-east-1"
+        }
+    },
+
+    "s3": {
+        "s3Config": {
+            "endpoint": "http://s3:9000",
+            "publicEndpoint": "http://s3.$PUTER_DOMAIN",
+            "accessKeyId": "puter",
+            "secretAccessKey": "$S3_SECRET_KEY",
+            "region": "us-east-1",
+            "forcePathStyle": true
+        }
+    },
+    "s3_bucket": "puter-local",
+    "s3_region": "us-east-1",
+
+    "providers": {
+        "ollama": { "enabled": false }
+    },
+
+    "trust_proxy": 1
+}
+EOF
+fi
+
+# ── Step 5: bring it up ─────────────────────────────────────────────
+log "docker compose up -d"
+docker compose up -d
+
+log ""
+log "stack starting. first boot takes ~30s while MariaDB initialises."
+log "follow puter logs:"
+log "    cd $PUTER_DIR && docker compose logs -f puter"
+log ""
+log "open http://$PUTER_DOMAIN:$PUTER_PORT once the puter container is healthy."
+log "first-boot admin password is logged once — grab it with:"
+log "    cd $PUTER_DIR && docker compose logs puter | grep password"

l_checker_config.json

@@ -1,26 +0,0 @@
-{
-    "ignore": ["**/!(*.js|*.css)", "**/assets/**"],
-    "license": "doc/license_header.txt",
-    "licenseFormats": {
-        "js": {
-            "prepend": "/*",
-            "append": " */",
-            "eachLine": {
-                "prepend": " * "
-            }
-        },
-        "dotfile|^Dockerfile": {
-            "eachLine": {
-                "prepend": "# "
-            }
-        },
-        "css": {
-            "prepend": "/*",
-            "append": " */",
-            "eachLine": {
-                "prepend": " * "
-            }
-        }
-    },
-    "trailingWhitespace": "TRIM"
-}

nginx/nginx.conf

@@ -0,0 +1,135 @@
+# Reverse proxy in front of Puter — mirrors what the prod ALB does:
+# accepts every Host header, forwards to the Puter container, and lets
+# the Puter app handle subdomain-based routing internally (api.*,
+# site.*, app.*, etc).
+#
+# To enable TLS:
+#   1. Drop your fullchain.pem + privkey.pem into ./puter/tls/.
+#   2. Uncomment the 443 server{} block below.
+#   3. Update server_name to your domain (and wildcard subdomains).
+
+worker_processes auto;
+events {
+    worker_connections 4096;
+}
+
+http {
+    # Required for Puter's WebSocket / socket.io upgrades.
+    map $http_upgrade $connection_upgrade {
+        default upgrade;
+        '' close;
+    }
+
+    # Rough size cap that mirrors prod ALB defaults; tune for your
+    # uploads. Puter chunks large uploads, so 1 GiB per request is plenty.
+    client_max_body_size 1024m;
+    proxy_read_timeout 600s;
+    proxy_send_timeout 600s;
+    proxy_buffering off;
+    server_tokens off;
+
+    upstream puter_backend {
+        server puter:4100;
+        keepalive 32;
+    }
+
+    upstream s3_backend {
+        # RustFS — see `s3` service in docker-compose.full.yml. Browsers
+        # PUT/GET here for presigned-URL uploads / downloads. Routed via
+        # the `s3.<domain>` subdomain so signature verification works
+        # (Host header preserved end-to-end) and so HTTPS stays clean
+        # (no mixed-content from a port-9000 host publish).
+        server s3:9000;
+        keepalive 32;
+    }
+
+    # ── HTTP (port 80) ─────────────────────────────────────────────
+    server {
+        listen 80;
+        listen [::]:80;
+        server_name ~^s3\.;
+
+        location / {
+            proxy_pass http://s3_backend;
+            proxy_http_version 1.1;
+            # Critical: preserve the original Host so RustFS validates
+            # the request against the same host the URL was signed for.
+            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;
+        }
+    }
+
+    server {
+        listen 80 default_server;
+        listen [::]:80 default_server;
+        server_name _;
+
+        # Note: when you enable TLS, replace this block with a redirect:
+        #   return 301 https://$host$request_uri;
+        location / {
+            proxy_pass http://puter_backend;
+            proxy_http_version 1.1;
+            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;
+            proxy_set_header X-Forwarded-Host $host;
+            proxy_set_header X-Forwarded-Port $server_port;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection $connection_upgrade;
+        }
+    }
+
+    # ── HTTPS (port 443) — uncomment after dropping certs in ./puter/tls/ ─
+    # server {
+    #     listen 443 ssl;
+    #     listen [::]:443 ssl;
+    #     http2 on;
+    #     server_name ~^s3\.;
+    #
+    #     ssl_certificate     /etc/nginx/tls/fullchain.pem;
+    #     ssl_certificate_key /etc/nginx/tls/privkey.pem;
+    #     ssl_protocols       TLSv1.2 TLSv1.3;
+    #     ssl_ciphers         HIGH:!aNULL:!MD5;
+    #     ssl_session_cache   shared:SSL:10m;
+    #     ssl_session_timeout 10m;
+    #
+    #     location / {
+    #         proxy_pass http://s3_backend;
+    #         proxy_http_version 1.1;
+    #         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;
+    #     }
+    # }
+    #
+    # server {
+    #     listen 443 ssl default_server;
+    #     listen [::]:443 ssl default_server;
+    #     http2 on;
+    #     server_name _;
+    #
+    #     ssl_certificate     /etc/nginx/tls/fullchain.pem;
+    #     ssl_certificate_key /etc/nginx/tls/privkey.pem;
+    #     ssl_protocols       TLSv1.2 TLSv1.3;
+    #     ssl_ciphers         HIGH:!aNULL:!MD5;
+    #     ssl_session_cache   shared:SSL:10m;
+    #     ssl_session_timeout 10m;
+    #
+    #     location / {
+    #         proxy_pass http://puter_backend;
+    #         proxy_http_version 1.1;
+    #         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;
+    #         proxy_set_header X-Forwarded-Host $host;
+    #         proxy_set_header X-Forwarded-Port $server_port;
+    #         proxy_set_header Upgrade $http_upgrade;
+    #         proxy_set_header Connection $connection_upgrade;
+    #     }
+    # }
+}