Tutorials · DevOps & Containers

Docker Basics on a NavEdge Edge Server: Run Your First Container

NavEdge edge servers run on-site applications in Docker containers. Learn the five commands you need: pull, run, ps, logs and restart policies.

Beginner15 min6 steps

Before you start

  • A NavEdge edge server or any Linux host with Docker Engine
  • SSH access with your own key
  • Internet access to a container registry

Step by step

  1. Check Docker

    Confirm the engine is running and your user may use it.

    docker version
    docker info --format '{{.ServerVersion}} {{.Driver}}'
    
  2. Pull an image by version

    Always pin a version tag instead of latest, so every site runs the same software.

    docker pull nginx:1.27-alpine
    
  3. Run it

    Give the container a name, publish a port, and set it to restart after a reboot or crash.

    docker run -d --name web --restart unless-stopped -p 8080:80 nginx:1.27-alpine
    
  4. Check it

    List containers, read the logs and test the port.

    docker ps
    docker logs --tail 50 web
    curl -I http://localhost:8080
    
  5. Update it

    Pull the new version, remove the old container and start the new one. Data in volumes is kept.

    docker pull nginx:1.27.3-alpine
    docker rm -f web
    docker run -d --name web --restart unless-stopped -p 8080:80 nginx:1.27.3-alpine
    
  6. Clean up

    Remove unused images to keep the edge server's disk free.

    docker image prune -a --filter "until=168h"
    

Commands are generic, industry-standard examples. Exact syntax and menu names vary by model and firmware; check your device's manual on the Documentation page.

Pro tips

  • Keep application data in named volumes or bind mounts, never inside the container.
  • Use docker compose (next tutorial) as soon as you have more than one container.