From fde5cc1c46904f1287f7d39d334fe234e3dfc4f1 Mon Sep 17 00:00:00 2001 From: Korbs Date: Mon, 20 May 2024 02:49:52 -0400 Subject: [PATCH] Update README --- README.md | 100 +++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 92 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index d8de716..507ae6e 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,105 @@ # Netweak Agent for Docker ![Cover](https://md.sudovanilla.org/images/network-plus-docker.png) -> This is an unofficial Docker Image for Netweak's agent. This was built so I can run it on Windows and macOS. +> This is an unofficial Docker Image for Netweak's agent. -When installing a new Netweak Agent, grab the token from the install instructions from your Netweak dashboard. Put the token into the `token.conf` file. -To run it, use Docker Compose v2 or newer: +## Running +### Requirements + - Supported OS: + - Linux + - macOS + - Windows 10 or newer + - Supported Architecture: + - x86_64 / amd64 + - arm64 / aarch64 + - Docker Engine: + - [Linux](https://docs.docker.com/engine/install/#supported-platforms) + - [macOS](https://richstone.io/best-way-to-install-docker-on-a-mac/) ([Homebrew](https://brew.sh/), without Docker Desktop) + - [Windows](https://dev.to/felipecrs/simply-run-docker-on-wsl2-3o8) ([WSL2](https://learn.microsoft.com/en-us/windows/wsl/install), without Docker Desktop) + +> For some setups, having `sudo` access may be required. + +### Docker Compose + + +Create a folder somewhere on your server called `netweak-agent`: +```bash +mkdir ./netweak-agent +cd ./netweak-agent +``` + +Create new files called `docker-compose.yml` and `token.conf`: +```bash +touch docker-compose.yml +touch token.conf +``` + +In the `docker-compose.yml` file, add the following: +```yml +services: + netweak-agent: + # For AMD64 Machines: + image: ark.sudovanilla.org/korbs/netweak-agent:amd64 + # For ARM64/V8 Machines: + # image: ark.sudovanilla.org/korbs/netweak-agent:arm64 + restart: unless-stopped + container_name: netweak_agent + volumes: + - ./token.conf:/etc/netweak/token.conf +``` + +Run the Docker Pull command to get download the Docker image: +``` +docker compose pull +``` + +![](https://md.sudovanilla.org/images/nafd-int-token.png) + +Now, try adding a new server to your Netweak dashboard and grab the token. The instructions on screen will show a command, you don't need this command for this setup, but you need the randomly generated token that is at the end of the provided command. Copy that and paste it into the `token.conf` file. + +Once done, click Continue in Netweak. + +Run the agent: ```bash docker compose up -d ``` -> You may need to use `sudo` depending on your OS and setup. -## FAQ -**Metric only shows around 60GB of disk space, why is that?** +After a few moment, Netweak will detect the agent if you've setup things correctly. -By default, at least in Docker Desktop on my Mac Mini M2, the virtual disk limit is set to 64GB. +## Questions and Answers +**Does this support macOS and Windows?** + +Yes, by using Docker it does support both of these operating systems. This has been tested successfully on a Mac Mini M2 running macOS 13/14. + +This should also work on the Raspberry Pi 4 and up. Although, this has not been tested. Contact me or leave an issue if you've gotten this to run on a Raspberry Pi, I would like to know. + +**Can I really trust providing my server's token?** + +SudoVanilla does not have access to any Docker containers you run on your server and does not have access to your Netweak account. + +**Metric information is wrong, why is this?** + +This depends on how Docker is setup, I've not yet looked into correcting this behavior. + +**Why does it say I'm running Debian? I'm not.** + +This Docker Image is based on slim edition of Debian 12. When the Netweak agent runs in this Docker Image, it will detect this and assume you're using Debian 12. This is expected behavior. **Is this an offical Docker Image for Netweak?** -No, SudoVanilla is not affiliated with Netweak in any way. This is NOT an official Docker image. SudoVanilla is only an enterprise customer of Netweak. \ No newline at end of file +No, SudoVanilla is not affiliated with Netweak in any way. This is NOT an official Docker image. SudoVanilla is only an enterprise customer of Netweak. + +**How do I uninstall the agent?** + +In Netweak, skip the uninstall instructions and just delete the server. + +As for on your server, run: +``` +cd ./netweak-agent +docker compose down +``` + +Then delete the `netweak-agent` folder you created. \ No newline at end of file