docs: fix technical inaccuracies in Local JSON destination documentation

docs/integrations/destinations/local-json.md

@@ -2,13 +2,13 @@
 
 :::danger
 
-This destination is meant to be used on a local workstation and won't work on Kubernetes
+This destination is meant to be used on a local workstation and won't work on Kubernetes production deployments. This is because the destination writes data to the local filesystem of the container, which is not accessible outside the pod in a Kubernetes environment unless you configure persistent volumes.
 
 :::
 
 ## Overview
 
-This destination writes data to a directory on the _local_ filesystem on the host running Airbyte. By default, data is written to `/tmp/airbyte_local`. To change this location, modify the `LOCAL_ROOT` environment variable for Airbyte.
+This destination writes data to a directory on the filesystem within the Airbyte container. All data is written under the `/local` directory inside the container.
 
 ### Sync Overview
 
@@ -37,39 +37,88 @@ This integration will be constrained by the speed at which your filesystem accep
 
 The `destination_path` will always start with `/local` whether it is specified by the user or not. Any directory nesting within local will be mapped onto the local mount.
 
-By default, the `LOCAL_ROOT` env variable in the `.env` file is set `/tmp/airbyte_local`.
-
-The local mount is mounted by Docker onto `LOCAL_ROOT`. This means the `/local` is substituted by `/tmp/airbyte_local` by default.
+The connector code enforces that all paths must be under the `/local` directory. If you provide a path that doesn't start with `/local`, it will be automatically prefixed with `/local`. Attempting to write to a location outside the `/local` directory will result in an error.
 
 :::caution
 
-Please make sure that Docker Desktop has access to `/tmp` (and `/private` on a MacOS, as /tmp has a symlink that points to /private. It will not work otherwise). You allow it with "File sharing" in `Settings -> Resources -> File sharing -> add the one or two above folder` and hit the "Apply & restart" button.
+When using abctl to deploy Airbyte locally, the data is stored within the Kubernetes cluster created by abctl. You'll need to use kubectl commands to access the data as described in the "Access Replicated Data Files" section below.
 
 :::
 
 ### Example:
 
 - If `destination_path` is set to `/local/cars/models`
-- the local mount is using the `/tmp/airbyte_local` default
-- then all data will be written to `/tmp/airbyte_local/cars/models` directory.
-
-## Access Replicated Data Files
-
-If your Airbyte instance is running on the same computer that you are navigating with, you can open your browser and enter [file:///tmp/airbyte_local](file:///tmp/airbyte_local) to look at the replicated data locally. If the first approach fails or if your Airbyte instance is running on a remote server, follow the following steps to access the replicated files:
-
-1. Access the scheduler container using `docker exec -it airbyte-server bash`
-2. Navigate to the default local mount using `cd /tmp/airbyte_local`
-3. Navigate to the replicated file directory you specified when you created the destination, using `cd /{destination_path}`
-4. List files containing the replicated data using `ls`
-5. Execute `cat {filename}` to display the data in a particular file
-
-You can also copy the output file to your host machine, the following command will copy the file to the current working directory you are using:
-
-```text
-docker cp airbyte-server:/tmp/airbyte_local/{destination_path}/{filename}.jsonl .
-```
-
-Note: If you are running Airbyte on Windows with Docker backed by WSL2, you have to use similar step as above or refer to this [link](/integrations/locating-files-local-destination.md) for an alternative approach.
+- then all data will be written to `/local/cars/models` directory inside the container
+
+## Using with Kubernetes (abctl)
+
+Since Airbyte runs in a Kubernetes cluster managed by abctl, you need to follow these steps to properly configure and access data:
+
+1. **Create a Persistent Volume**
+   - First, create a persistent volume claim (PVC) in your Kubernetes cluster:
+     ```
+     kubectl --kubeconfig ~/.airbyte/abctl/abctl.kubeconfig --namespace airbyte-abctl apply -f - <<EOF
+     apiVersion: v1
+     kind: PersistentVolumeClaim
+     metadata:
+       name: local-json-data
+     spec:
+       accessModes:
+         - ReadWriteOnce
+       resources:
+         requests:
+           storage: 1Gi
+     EOF
+     ```
+
+2. **Configure the Destination**
+   - When setting up your Local JSON destination, set the destination path to `/local/data`
+   - In the Airbyte UI, create or edit your connection to use this destination
+
+3. **Access Data After Sync Completion**
+   - For completed pods where the data is stored in the persistent volume, create a temporary pod with the volume mounted:
+     ```
+     kubectl --kubeconfig ~/.airbyte/abctl/abctl.kubeconfig --namespace airbyte-abctl apply -f - <<EOF
+     apiVersion: v1
+     kind: Pod
+     metadata:
+       name: file-access
+     spec:
+       containers:
+       - name: file-access
+         image: busybox
+         command: ["sh", "-c", "ls -la /data && sleep 3600"]
+         volumeMounts:
+         - name: data-volume
+           mountPath: /data
+       volumes:
+       - name: data-volume
+         persistentVolumeClaim:
+           claimName: local-json-data
+     EOF
+     ```
+   - Then access the pod to view files:
+     ```
+     kubectl --kubeconfig ~/.airbyte/abctl/abctl.kubeconfig --namespace airbyte-abctl exec -it file-access -- sh
+     ```
+   - To view file contents directly:
+     ```
+     kubectl --kubeconfig ~/.airbyte/abctl/abctl.kubeconfig --namespace airbyte-abctl exec -it file-access -- cat /data/your_stream_name/*.jsonl
+     ```
+   - When finished, delete the temporary pod:
+     ```
+     kubectl --kubeconfig ~/.airbyte/abctl/abctl.kubeconfig --namespace airbyte-abctl delete pod file-access
+     ```
+
+4. **Alternative: View File Paths in Logs**
+   - If you can't mount the volume, you can at least see the file paths in the logs:
+     ```
+     kubectl --kubeconfig ~/.airbyte/abctl/abctl.kubeconfig --namespace airbyte-abctl logs <pod-name> | grep "File output:"
+     ```
+
+Note: The exact pod name will depend on your specific connection ID and sync attempt. Look for pods with names containing "destination" and your connection ID.
+
+If you are running Airbyte on Windows, you may need to adjust these commands accordingly. You can also refer to the [alternative file access methods](/integrations/locating-files-local-destination.md) for other approaches.
 
 ## Changelog