feat(docs): migrate documentation site into monorepo (#5912)

apps/docs/docs/integrations/docker/index.mdx

@@ -0,0 +1,156 @@
+---
+title: 'Docker'
+description: "Docker is a platform where you can run your applications in containers, allowing for easy deployment and management of applications."
+hide_title: true
+---
+
+import { IntegrationHeader } from '@site/src/components/integrations/header';
+import { IntegrationCapabilites } from '@site/src/components/integrations/widgets';
+import {IntegrationSecrets} from '@site/src/components/integrations/secrets';
+import { IconBrandDocker, IconTool } from "@tabler/icons-react";
+import { dockerIntegration } from '.';
+import { dockerContainersWidget } from '@site/docs/widgets/docker-containers';
+
+
+<IntegrationHeader
+  integration={dockerIntegration}
+  categories={['Containers']}
+/>
+
+### Widgets & Capabilities
+<IntegrationCapabilites
+    items={[{
+      widget: dockerContainersWidget,
+      note: "This widget can only be used with administrator privileges"
+    }]}
+/>
+
+
+## Enabling the Docker integration
+This integration must first be enabled.
+If you directly run on the host system and you have docker installed, it will be enabled by default.
+Otherwise, you'll need to mount the [docker socket](https://docs.docker.com/engine/security/protect-access/) to the Homarr container,
+so Homarr can interact with the Docker service.
+
+In Docker Compose, you can simply add this line:
+
+```yaml {10}
+#---------------------------------------------------------------------#
+#     Homarr - A simple, yet powerful dashboard for your server.      #
+#---------------------------------------------------------------------#
+services:
+  homarr:
+    container_name: homarr
+    image: ghcr.io/homarr-labs/homarr:latest
+    restart: unless-stopped
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock # <--- add this line here!
+      - ./homarr/appdata:/appdata
+    environment:
+      - SECRET_ENCRYPTION_KEY=your_64_character_hex_string # <--- can be generated with `openssl rand -hex 32`
+    ports:
+      - '7575:7575'
+```
+
+With docker run, add this parameter: `-v /var/run/docker.sock:/var/run/docker.sock`.
+In Windows, you'll need to adjust the slashes: `-v //var/run/docker.sock:/var/run/docker.sock`
+
+### Managing your Docker containers within Homarr
+Homarr allows you to interact with Docker containers running on your system.
+Each container row has an action menu with the following options:
+- **View logs** — opens a dedicated logs page with a live terminal
+- **Start** — start a stopped container
+- **Stop** — stop a running container
+- **Restart** — restart a container
+- **Remove** — remove a container
+- **Add to Homarr** — create a bookmark app from the container
+
+You can also search and filter containers by **container** or **image** name:
+
+![Container and Image Search](img/container-and-image-search.png)
+
+#### Viewing container logs
+
+You can view the real-time logs of any container by selecting **View logs** from the row action menu.
+This opens a dedicated page with an xterm.js terminal that streams the container's log output.
+
+#### CPU and Memory columns
+
+The Docker management table supports optional **CPU usage** and **Memory usage** columns.
+These columns are hidden by default and can be toggled on from the table column visibility settings.
+
+#### Add apps from containers
+
+Homarr also lets you add apps from containers. You can simply select all containers you want to add an app for and then click the `Add to Homarr` button.
+This will open a dialog where you can specify the web addresses for all of them:
+
+![Dialog for addding apps to Homarr](img/add-to-homarr-dialog.png)
+
+Once you've changed the web addresses, click the `Add` button to add the apps to Homarr.
+They are then available in the app list and can be used as normally added apps.
+
+![Apps added from containers](img/add-to-homarr-apps.png)
+
+### Configuration
+
+Currently Homarr supports one label for configuration of the containers:
+
+- **homarr.hide:** If set to any value, the container will be hidden from the Docker Containers widget and tools page.
+
+### Security
+Mounting docker sockets can be risky, as they permit full control over your docker service.
+As an example, a thread actor could abuse Homarr use the socket to start, stop or delete containers on your system.
+
+Therefore we recommend the usage of a socket proxy, which can prohibit certain actions.
+A few examples include:
+- https://github.com/linuxserver/docker-socket-proxy
+- https://github.com/Tecnativa/docker-socket-proxy
+
+See documentation of the respective proxies on how to configure them.
+Homarr may behave in unexpected ways when you use proxies.
+
+#### Permissions
+Homarr needs the following permissions from the Docker API:
+- Containers/Start
+- Containers/Stop
+- Containers/Restart
+- Containers/Remove
+
+For socket proxies, you will need these permissions:
+- `CONTAINERS=1`
+- `POST=1`
+
+**Caution:** `POST` access is security critical as it provides extensive capabilities to modify your docker environment. Please leave it disabled if you're concerned about this.
+
+As a workaround, you can use [LSIO's socket proxy](https://github.com/linuxserver/docker-socket-proxy) and set the following:
+- ALLOW_START=1
+- ALLOW_STOP=1
+- ALLOW_RESTARTS=1
+
+These will work even with `POST=0`. 
+
+You lose the ability to remove containers, but start, stop and restarts should work just fine.
+
+#### Connecting to Docker via Socket Proxies
+To connect to Docker via a socket proxy, you'll need to add these two environment variables in the compose file:
+- `DOCKER_HOSTNAMES=<name of the socket proxy container>`
+- `DOCKER_PORTS=<socket proxy port, usually 2375>`
+
+Refer: https://homarr.dev/docs/advanced/environment-variables/
+
+You will also need to add Homarr to the network of your socket proxy. You can do it like this:
+1. Add the network to your compose file (with appropriate changes):
+```yaml
+networks:
+  socket-proxy:
+    name: socket-proxy # <--- change this to the name of the network as set up by the socket proxy
+    external: true
+```
+
+2. Add the network to the homarr service in the compose file:
+```yaml
+networks:
+  - socket-proxy
+```
+
+3. Finally, if it is present, remove the default docker socket connection under `volumes` in the homarr service.

apps/docs/docs/integrations/docker/index.ts

@@ -0,0 +1,9 @@
+import { IntegrationDefinition } from "@site/src/types";
+
+export const dockerIntegration: IntegrationDefinition = {
+  name: "Docker",
+  description:
+    "Docker is a platform where you can run your applications in containers, allowing for easy deployment and management of applications.",
+  iconUrl: "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/docker.svg",
+  path: "../../integrations/docker",
+};