This guide walks you through cloning the repository, setting up your environment, and opening the router dashboard for the first time. The entire process takes around five minutes on a machine that already has PHP and Node.js installed.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/KevinCruz-cell/Redes-de-comunicaciones-/llms.txt
Use this file to discover all available pages before exploring further.
Check prerequisites
Make sure the following tools are available on your machine before you begin.
| Tool | Required version | Check |
|---|---|---|
| PHP | 8.2 or later | php --version |
| Composer | 2.x | composer --version |
| Node.js | 18 LTS or later | node --version |
| npm | bundled with Node.js | npm --version |
Your machine must be connected to the same local network as the OpenWrt router. A direct Ethernet connection to the router is strongly recommended.
Configure your environment
Copy the example environment file and open it in your editor.Add your router’s connection details. These variables are not present in
.env.example by default, so add them at the end of the file:| Variable | Default | Description |
|---|---|---|
ROUTER_IP | 192.168.10.1 | IP address of your OpenWrt router |
ROUTER_USER | root | SSH username (OpenWrt default is root) |
ROUTER_PASSWORD | (empty) | SSH password set on the router |
ROUTER_PORT | 22 | SSH port |
ROUTER_TIMEOUT | 5 | HTTP reachability check timeout in seconds |
Run the setup script
A single Composer script installs all PHP and JavaScript dependencies, generates the application key, runs database migrations, and compiles frontend assets:This command runs the following steps in sequence:
Start the development server
| Process | Role |
|---|---|
php artisan serve | Laravel HTTP server on http://localhost:8000 |
php artisan queue:listen | Background job worker |
php artisan pail | Real-time log viewer |
npm run dev | Vite asset bundler with hot reload |
Open the app and log in
Navigate to
http://localhost:8000 in your browser. You will see a login form asking for a username and password.Enter your router’s credentials — the same values you set in ROUTER_USER and ROUTER_PASSWORD. The application will:- Check that the router is reachable at
ROUTER_IP. - Authenticate against the LuCI web interface.
- Store the session token (
sysauthcookie) in your PHP session.
If the login page shows “No se detecto el router en 192.168.10.1”, verify that your machine is on the same network as the router and that
ROUTER_IP is set correctly in .env.Next steps
Configure your connection
Learn about all available environment variables and how the SSH and HTTP auth flows work.
Dashboard
Understand what system metrics the dashboard collects and how they are fetched.