A modern web interface for editing iPXE boot menus and managing local asset mirrors for the netboot.xyz ecosystem.

• 🔧 Menu Editor: Visual interface for editing iPXE configuration files
• 📦 Asset Management: Download and mirror boot assets locally for faster performance
• 🔄 Real-time Updates: Live menu updates with WebSocket integration
• 📊 System Monitoring: Track download progress and system status
• 🐳 Docker Integration: Seamlessly integrated with docker-netbootxyz

• Node.js 18+ for development
• Docker for containerized deployment

1. Clone and setup:

   git clone https://github.com/netbootxyz/webapp
   cd webapp
   npm install

2. Run tests:

   npm test              # Run unit tests
   npm run test:coverage # Run with coverage report
   npm run test:watch    # Watch mode for development

3. Start development server:

   npm start             # Start the webapp

git clone https://github.com/netbootxyz/webapp
cd webapp
git clone https://github.com/netbootxyz/docker-netbootxyz
docker build . -t netbootxyz-webapp

docker run -d \
  --name=netbootxyz-webapp \
  -e MENU_VERSION=2.0.84             # optional: specify menu version \
  -p 3000:3000                       # webapp interface \
  -p 69:69/udp                       # TFTP server \
  -p 8080:80                         # NGINX asset server \
  -v /local/path/to/config:/config   # optional: persistent config \
  -v /local/path/to/assets:/assets   # optional: asset cache \
  --restart unless-stopped \
  netbootxyz-webapp

For the latest development version with cutting-edge features:

docker run -d \
  --name=netbootxyz-webapp-dev \
  -e MENU_VERSION=2.0.84             # optional: specify menu version \
  -p 3000:3000                       # webapp interface \
  -p 69:69/udp                       # TFTP server \
  -p 8080:80                         # NGINX asset server \
  -v /local/path/to/config:/config   # optional: persistent config \
  -v /local/path/to/assets:/assets   # optional: asset cache \
  --restart unless-stopped \
  ghcr.io/netbootxyz/webapp-dev:latest

The webapp includes comprehensive test coverage (90%+ coverage):

# Available test commands
npm test                 # Run unit tests (fastest)
npm run test:all         # Run all tests including integration
npm run test:coverage    # Generate coverage report
npm run test:watch       # Watch mode for development
npm run test:integration # Integration tests only
npm run test:debug       # Debug mode with verbose output

• 62 test cases covering core functionality
• 90% code coverage with branch coverage
• Sub-second test execution for rapid development feedback

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Run tests: npm test
4. Commit changes: git commit -m 'Add amazing feature'
5. Push to branch: git push origin feature/amazing-feature
6. Open a Pull Request

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• netboot.xyz - Main boot menu system
• docker-netbootxyz - Docker container implementation
• netboot.xyz-docs - Documentation site