Title: Installation Docs: bash bootstrap.sh Command Conflicts with Dokku Installer File
Body:
Hi there,
I encountered an issue following the "Install Using Script" documentation at https://shokku.dev/docs/installation that can be confusing, especially for users less familiar with Linux file handling.
Problem:
The official Dokku installation process (wget https://dokku.com/install/.../bootstrap.sh) downloads a script named bootstrap.sh, often into the /root/ directory or wherever the user runs the command.
Subsequently, following the Shokku installation instructions:
wget "https://shokku.dev/bootstrap.sh"
# export SHOKKU_LETSENCRYPT_EMAIL="foo@example.com" # (Assuming global email is set)
bash bootstrap.sh
Causes a problem:
- The
wget "https://shokku.dev/bootstrap.sh" command downloads the Shokku installer.
- Because
bootstrap.sh (from the Dokku install) already exists in the directory, wget automatically renames the new Shokku script to bootstrap.sh.1.
- The final documented command,
bash bootstrap.sh, then executes the original Dokku installation script again, not the intended Shokku script (bootstrap.sh.1).
Steps to Reproduce:
- Install Dokku using the official bootstrap script, downloading
bootstrap.sh to a directory (e.g., /root/).
- In the same directory, run
wget "https://shokku.dev/bootstrap.sh".
- Observe that the file is saved as
bootstrap.sh.1.
- Run the documented command
bash bootstrap.sh.
- Observe that the Dokku installation process/checks run, not the Shokku installation.
Expected Behavior:
The documented commands should result in the Shokku installation script being executed.
Actual Behavior:
The documented bash bootstrap.sh command runs the previously downloaded Dokku installer script due to the filename collision and automatic renaming by wget.
Consequences:
This is confusing and led to significant troubleshooting time (in my case, I initially thought it was a server resource issue). Users might repeatedly run the Dokku installer or not realize why Shokku isn't installing.
Suggested Solution:
Could the documentation please be updated to account for this likely filename conflict? Perhaps:
- Add a note warning users about the potential conflict.
- Instruct users to check if the file was saved as
bootstrap.sh.1 and run bash bootstrap.sh.1 if necessary.
- Alternatively, suggest downloading the Shokku script with a different name using
wget -O shokku_bootstrap.sh "...".
Thanks for providing Shokku!
Title: Installation Docs:
bash bootstrap.shCommand Conflicts with Dokku Installer FileBody:
Hi there,
I encountered an issue following the "Install Using Script" documentation at https://shokku.dev/docs/installation that can be confusing, especially for users less familiar with Linux file handling.
Problem:
The official Dokku installation process (
wget https://dokku.com/install/.../bootstrap.sh) downloads a script namedbootstrap.sh, often into the/root/directory or wherever the user runs the command.Subsequently, following the Shokku installation instructions:
Causes a problem:
wget "https://shokku.dev/bootstrap.sh"command downloads the Shokku installer.bootstrap.sh(from the Dokku install) already exists in the directory,wgetautomatically renames the new Shokku script tobootstrap.sh.1.bash bootstrap.sh, then executes the original Dokku installation script again, not the intended Shokku script (bootstrap.sh.1).Steps to Reproduce:
bootstrap.shto a directory (e.g.,/root/).wget "https://shokku.dev/bootstrap.sh".bootstrap.sh.1.bash bootstrap.sh.Expected Behavior:
The documented commands should result in the Shokku installation script being executed.
Actual Behavior:
The documented
bash bootstrap.shcommand runs the previously downloaded Dokku installer script due to the filename collision and automatic renaming bywget.Consequences:
This is confusing and led to significant troubleshooting time (in my case, I initially thought it was a server resource issue). Users might repeatedly run the Dokku installer or not realize why Shokku isn't installing.
Suggested Solution:
Could the documentation please be updated to account for this likely filename conflict? Perhaps:
bootstrap.sh.1and runbash bootstrap.sh.1if necessary.wget -O shokku_bootstrap.sh "...".Thanks for providing Shokku!