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