Safe workflow
- 1Stop the server before replacing core application files when possible.
- 2Create a backup first if you have a backup slot.
- 3Upload or edit the files in Hydrodactyl.
- 4Confirm the main file and dependency files are in the expected directory.
- 5Start the server and watch the console for errors.
- Bot projects can use package.json, requirements.txt, a .csproj file, Maven/Gradle files, go.mod, Cargo.toml, composer.json, or other files required by the selected runtime.
- Make sure the startup file or compiled output matches the variable configured by the selected bot egg.
- Static web projects need an entry page such as index.html in the location expected by the selected runtime.
Archives
For large projects, uploading a ZIP or tar archive and extracting it in the panel is often faster than uploading thousands of small files. After extraction, check that the project did not end up inside an extra nested folder.
Common mistake
If the startup command expects a file in the server root but your upload created project/project/main.py or project/project/index.html, the server may report that the file does not exist.