Skip to main content

Installation

Stranola is distributed as a ready-to-run Docker image. This This page covers the simplest way to get started—for options on advanced deployment options (compile from source code, docker run standalone, (rollback, backups) see README_docker.md in the project repository.

Requirements​

  • A Linux host with Docker and Docker Compose installed.
  • Ensure that the host's network interfaces are accessible to the client PCs that you want to boot and clone — Stranola must serve DHCP, TFTP, and PXE directly on the LAN, so the container runs with network from the host (host networking) instead of Docker's isolated bridge mode.

Get it started​

Create a file named docker-compose.yaml with the following content:

services:
  netedge:
    image: stranola/netedge:latest
    network_mode: host          # comparte la red del host (PXE/DHCP/multicast)
    cap_add: [NET_ADMIN, NET_RAW, NET_BIND_SERVICE]
    volumes:
      - netedge-data:/data
    restart: unless-stopped
volumes:
  netedge-data:

And here we go:

docker compose up -d

And that's it—the image is downloaded already compiled, so docker compose up -d starts up in seconds; nothing is compiled on your server. All data (database, images, keys, license) remain on the volume named netedge-data, not in the container.

Access​

Open http://<ip-del-host>:8080 in a browser.

Login screen

The default credentials are:

  • User: admin
  • Password: netedge

Port​

By default, Stranola listens on port 8080 for the web interface and the API. With the host network, you have all the ports you need—the control panel, DHCP, TFTP, and The netdd transfer ports — are already accessible on the LAN without the need to map additional ports.

Update​

Since the data resides in the volume netedge-data and not in the container, Updating to the latest released version is as simple as pulling the image new and recreate the container from the same directory where you have the docker-compose.yaml:

docker compose pull
docker compose up -d

docker compose pull Download the latest image stranola/netedge:latest published on Docker Hub, and docker compose up -d recreates the container with It. Your data (database, images, passwords, license) is retained and New schema migrations are applied automatically at startup.

What's Next​

Go to Initial Setup to configure your network, Create a recipe, add some nodes, and run your first clone of from beginning to end.