{"id":27872417,"url":"https://github.com/thisloke/wol-server","last_synced_at":"2025-05-05T01:01:44.753Z","repository":{"id":289164458,"uuid":"811426466","full_name":"thisloke/wol-server","owner":"thisloke","description":"Script to boot delemaco","archived":false,"fork":false,"pushed_at":"2025-04-21T21:30:17.000Z","size":40,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-21T22:22:52.410Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thisloke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-06T15:18:53.000Z","updated_at":"2025-04-21T21:29:57.000Z","dependencies_parsed_at":"2025-04-21T22:22:54.733Z","dependency_job_id":"ed0ac783-da97-4fbb-b33e-def129a769e0","html_url":"https://github.com/thisloke/wol-server","commit_stats":null,"previous_names":["thisloke/wol-server"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisloke%2Fwol-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisloke%2Fwol-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisloke%2Fwol-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisloke%2Fwol-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thisloke","download_url":"https://codeload.github.com/thisloke/wol-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252420975,"owners_count":21745152,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-05T01:00:57.476Z","updated_at":"2025-05-05T01:01:44.678Z","avatar_url":"https://github.com/thisloke.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WOL Server - Wake-on-LAN Control Panel for Raspberry Pi\n\nA lightweight web-based Wake-on-LAN control panel designed for Raspberry Pi that lets you remotely power on and shut down your network devices.\n\n![WOL Server Screenshot](https://i.imgur.com/example.jpg)\n\n## Features\n\n- **Simple Web Interface**: Boot and shut down your server with a clean, responsive UI\n- **Status Monitoring**: Check if your target device is online\n- **Raspberry Pi Optimized**: Built specifically for ARM processors found in all Raspberry Pi models\n- **Secure Shutdown**: Password-protected shutdown functionality\n- **Lightweight**: Minimal resource usage ideal for running on even the oldest Pi models\n- **Easy Setup**: Simple installation process with clear instructions\n\n## Installation\n\n### Prerequisites\n\n- Raspberry Pi (any model) running Raspberry Pi OS\n- Network connection\n- Basic knowledge of SSH/terminal\n\n### Option 1: One-Command Installation\n\n1. **Download the latest release** on your local machine from the [Releases page](https://github.com/thisloke/wol-server/releases)\n\n2. **Transfer the package to your Raspberry Pi** using SCP:\n   ```bash\n   scp wol-server.tar.gz pi@your-pi-ip:~/\n   ```\n\n3. **SSH into your Raspberry Pi**:\n   ```bash\n   ssh pi@your-pi-ip\n   ```\n\n4. **Install with a single command**:\n   ```bash\n   tar -xzf wol-server.tar.gz \u0026\u0026 ./install.sh\n   ```\n\n5. **Access the web interface** at:\n   ```\n   http://your-pi-ip:8080\n   ```\n\n### Option 2: Manual Installation\n\nIf you prefer a manual approach or encounter issues with the automated install:\n\n1. **Create installation directory**:\n   ```bash\n   mkdir -p ~/wol-server/templates\n   ```\n\n2. **Transfer and install program files**:\n   ```bash\n   # Copy the executable\n   cp wol-server-arm6 ~/wol-server/wol-server\n   chmod +x ~/wol-server/wol-server\n\n   # Copy template files\n   cp templates/* ~/wol-server/templates/\n\n   # Create .env file\n   cat \u003e ~/wol-server/.env \u003c\u003c EOL\n   SERVER_NAME=pippo\n   SERVER_USER=root\n   MAC_ADDRESS=aa:bb:cc:dd:ee:ff\n   PORT=8080\n   EOL\n   ```\n\n3. **Install service**:\n   ```bash\n   sudo cp wol-server.service /etc/systemd/system/\n   sudo systemctl daemon-reload\n   sudo systemctl enable wol-server\n   sudo systemctl start wol-server\n   ```\n\n4. **Install required dependencies**:\n   ```bash\n   sudo apt-get update\n   sudo apt-get install -y wakeonlan sshpass\n   ```\n\n## Configuration\n\nThe application can be configured by editing the `.env` file in the installation directory:\n\n```bash\nnano ~/wol-server/.env\n```\n\n### Available Configuration Options\n\n| Setting | Description | Default |\n|---------|-------------|---------|\n| `SERVER_NAME` | Hostname/IP of target server | pippo |\n| `SERVER_USER` | SSH username for shutdown | root |\n| `MAC_ADDRESS` | MAC address for Wake-on-LAN | aa:bb:cc:dd:ee:ff |\n| `PORT` | Web interface port | 8080 |\n\nAfter changing configuration, restart the service:\n```bash\nsudo systemctl restart wol-server\n```\n\n## Usage\n\n### Accessing the Interface\n\nOpen a web browser and navigate to:\n```\nhttp://your-pi-ip:8080\n```\n\n### Features\n\n- **Status Checking**: The interface shows the current status (Online/Offline)\n- **Booting**: Click the \"Boot\" button to send a WOL magic packet\n- **Shutting Down**: Click \"Shutdown\" and enter your SSH password when prompted\n\n## Maintenance\n\n### Checking Service Status\n\n```bash\nsudo systemctl status wol-server\n```\n\n### Viewing Logs\n\n```bash\nsudo journalctl -u wol-server -f\n```\n\n### Updating\n\nTo update to a newer version:\n\n1. Download and transfer the latest release\n2. Stop the service:\n   ```bash\n   sudo systemctl stop wol-server\n   ```\n3. Extract the new files:\n   ```bash\n   tar -xzf wol-server.tar.gz\n   ```\n4. Run the install script:\n   ```bash\n   ./install.sh\n   ```\n\n## Troubleshooting\n\n### Service Won't Start\n\nCheck for template errors:\n```bash\nls -la ~/wol-server/templates/\n```\n\nVerify the .env file exists:\n```bash\ncat ~/wol-server/.env\n```\n\n### Boot Command Not Working\n\n1. Ensure `wakeonlan` is installed:\n   ```bash\n   which wakeonlan || sudo apt-get install wakeonlan\n   ```\n2. Verify the MAC address is correct in your .env file\n3. Make sure the target device is properly configured for Wake-on-LAN\n\n### Shutdown Not Working\n\n1. Verify `sshpass` is installed:\n   ```bash\n   which sshpass || sudo apt-get install sshpass\n   ```\n2. Check that the SERVER_USER setting in .env is correct\n3. Ensure SSH access is working between your Pi and the target server\n\n## Advanced Configuration\n\n### Running on a Different Port\n\nEdit the `.env` file:\n```bash\necho \"PORT=8181\" \u003e\u003e ~/wol-server/.env\n```\n\n### Multiple Target Machines\n\nTo control multiple devices, you can install multiple instances:\n```bash\n# Create a second instance\nmkdir -p ~/wol-server2/templates\ncp -r ~/wol-server/templates/* ~/wol-server2/templates/\ncp ~/wol-server/wol-server ~/wol-server2/\n\n# Different config\ncat \u003e ~/wol-server2/.env \u003c\u003c EOL\nSERVER_NAME=server2\nSERVER_USER=admin\nMAC_ADDRESS=aa:bb:cc:dd:ee:ff\nPORT=8081\nEOL\n\n# Create a new service\nsudo cp /etc/systemd/system/wol-server.service /etc/systemd/system/wol-server2.service\nsudo sed -i 's|/home/pi/wol-server|/home/pi/wol-server2|g' /etc/systemd/system/wol-server2.service\nsudo systemctl daemon-reload\nsudo systemctl enable wol-server2\nsudo systemctl start wol-server2\n```\n\n## Project Information\n\nDesigned for use with Raspberry Pi to provide a simple way to manage servers and devices on your local network. The web interface makes it easy to power on and off machines without having to remember MAC addresses or commands.\n\n### Contributing\n\nContributions are welcome! Feel free to submit pull requests or open issues to help improve this project.\n\n### License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthisloke%2Fwol-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthisloke%2Fwol-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthisloke%2Fwol-server/lists"}