Primeros Pasos

Goxe está diseñado para transformar flujos de logs caóticos en datos accionables. En esta guía, configuraremos tu primer pipeline para que pases de miles de líneas repetitivas a un resumen inteligente, optimizando tu almacenamiento desde el primer minuto.

¿Cómo empezar?

Instalar Goxe

Primero necesitas instalar Goxe; puedes instalarlo desde diferentes fuentes.

Si tienes Go instalado. Opción recomendada.

Ejecuta el siguiente comando para descargar y compilar el proyecto:
Terminal
```
go install github.com/DumbNoxx/Goxe/cmd/goxe@latest
```
Goxe es un binario independiente sin dependencias externas, solo descarga y ejecuta.
Verifica la instalación:
Terminal
```
goxe -v
# v1.1.2
```
Ejecuta Goxe:
Terminal
```
goxe
# Server listening on port: 1729
```

En Linux tienes diferentes formas de instalarlo.

Descarga el archivo correspondiente a la arquitectura de tu PC.

Download .deb (x64)

Download .deb (ARMx64)

El siguiente paso sería hacer doble clic o usar:

sudo apt install /ruta/a/Goxe_1.1.2_linux_amd64.deb # O arm64

Verifica la instalación:
Ubuntu Shell
```
goxe -v
# v1.1.2
```
Debería mostrarse la última versión.
Ejecuta Goxe:
Ubuntu Shell
```
goxe
# Server listening on port: 1729
```

Descarga el archivo correspondiente a la arquitectura de tu PC.

Download .rpm (x64)

Download .rpm (ARMx64)

El siguiente paso sería hacer doble clic o usar:

sudo dnf install /ruta/a/Goxe_1.1.2_linux_amd64.rpm # O arm64

Verifica la instalación:
Fedora Shell
```
goxe -v
# v1.1.2
```
Debería mostrarse la última versión.
Ejecuta Goxe:
Fedora Shell
```
goxe
# Server listening on port: 1729
```

En el caso de Arch Linux tienes dos opciones temporalmente.

Al igual que con Ubuntu, Goxe no está en los repositorios oficiales, pero se encuentra en el AUR.

Elige el asistente (helper) que utilices.
Arch Shell
yay -S goxe
Arch Shell
paru -S goxe
Goxe también tiene su binario pre-compilado en el AUR, por lo que puedes instalarlo con paru o yay.
Arch Shell
yay -S goxe-bin
Si usas esta versión, recuerda reemplazar goxe con goxe-bin en los siguientes pasos. Además, ten en cuenta que esta versión ya está pre-compilada, por lo que omitirá el proceso de compilación.
Confirma la instalación.
Tu asistente de AUR descargará automáticamente el código fuente y lo compilará. Dado que Goxe no tiene dependencias externas, el proceso es limpio y rápido. Simplemente presiona Enter cuando se te soliciten confirmaciones de instalación.
Verifica la instalación:
Arch Shell
```
goxe -v
# v1.1.2
```
Debería mostrarse la última versión.
Ejecuta Goxe:
Arch Shell
```
goxe
# Server listening on port: 1729
```

El binario pre-compilado está disponible para descarga directa en formato .tar.gz.

Download .tar.gz (x64)

Download .tar.gz (ARMx64)

Crea la carpeta de destino:
Terminal
```
mkdir -p /destino/goxe
```
Este directorio almacenará el binario extraído. El ejecutable se expondrá globalmente mediante un enlace simbólico.
Extrae el archivo:
Terminal
```
tar -xzvf Goxe_1.1.2_linux_amd64.tar.gz -C /destino/goxe # O arm64
```
Usa el mismo directorio que creaste en el paso anterior.
Haz que el binario sea ejecutable y crea un enlace simbólico:
Terminal
```
chmod +x /destino/goxe/Goxe
sudo ln -s ~/destino/goxe/Goxe /usr/local/bin/goxe
```
La creación del enlace simbólico requiere permisos de sudo.
Ejecuta Goxe:
Terminal
```
goxe
# Server listening on port: 1729
```
El enlace simbólico te permite ejecutar goxe globalmente mientras mantienes el binario en su propio directorio.

En Windows, puedes descargar el binario pre-compilado en formato .zip.

Download .zip (x64)

Download .zip (ARMx64)

Extrae el archivo descargado en la ubicación de tu preferencia.
(Opcional) Agrega Goxe al PATH del sistema para acceso global:
- Abre el Menú de Inicio y busca “Variables de entorno”.
- Selecciona “Editar las variables de entorno del sistema”.
- Haz clic en “Variables de entorno”.
- En “Variables del sistema”, busca y selecciona la variable “Path”, luego haz clic en “Editar”.
- Haz clic en “Nuevo” y añade la ruta de la carpeta donde extrajiste Goxe.
- Haz clic en “Aceptar” para cerrar todos los cuadros de diálogo.

Abre el Símbolo del sistema (CMD) y verifica la instalación:
Command Prompt
```
goxe -v
# v1.1.2
```
Debería mostrarse la última versión.
Ejecuta Goxe:
Command Prompt
```
goxe
# Server listening on port: 1729
```

Si prefieres usar PowerShell, sigue estos pasos para ejecutar Goxe:

Abre PowerShell.
Navega al directorio donde extrajiste Goxe:
PowerShell
```
cd "C:\ruta\a\goxe"
```

Ejecuta Goxe:

.\goxe.exe
# Server listening on port: 1729

También puedes ejecutar Goxe directamente desde el Explorador de archivos de Windows.

Abre el Explorador de archivos.
Navega al directorio donde extrajiste Goxe.
Haz doble clic en el archivo goxe.exe.
Se abrirá una ventana de terminal y Goxe se iniciará:
```
Server listening on port: 1729
```

El binario pre-compilado está disponible para descarga directa en formato .tar.gz.

Download .tar.gz (x64)

Download .tar.gz (ARMx64)

Crea un directorio para el binario:
Terminal
```
mkdir -p ~/goxe
```
Este directorio almacenará el binario de Goxe. Se creará un enlace simbólico para el acceso global.

Extrae el archivo:

tar -xzvf Goxe_1.1.2_macos_amd64.tar.gz -C ~/goxe

Haz que el binario sea ejecutable y expónlo globalmente:
Terminal
```
chmod +x ~/goxe/Goxe
sudo ln -s ~/goxe/Goxe /usr/local/bin/goxe
```
La creación del enlace simbólico requiere permisos de sudo.
Si macOS bloquea el binario, elimina el flag de cuarentena:
Terminal
```
xattr -d com.apple.quarantine ~/goxe/Goxe
```
Esto es necesario para binarios no firmados descargados de internet.
Ejecuta Goxe:
Terminal
```
goxe
# Server listening on port: 1729
```

¡Ya tienes Goxe en tu sistema! Cualquier reporte de error o sugerencia de mejora puede enviarse a través de:

Repositorio de Issues