Skip to content

Commit c244d2a

Browse files
Add troubleshooting guide for LaravelFS on Ubuntu
Provide steps to resolve the "command not found" issue caused by Composer's bin folder not being in the PATH. This enhances the README's usability for Ubuntu users.
1 parent 70c5551 commit c244d2a

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

README.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,34 @@ A starter kit must meet the following requirements:
131131

132132
---
133133

134+
## **🐧 Ubuntu Users: Fixing LaravelFS Command Not Found Issue**
135+
136+
If you installed LaravelFS but **can’t run the `laravelfs` command**,
137+
it might be because Composer's global bin folder is **not in your system's PATH**.
138+
139+
### **🔧 Solution: Add Composer Bin to PATH**
140+
1️⃣ Open your terminal and edit the `~/.bashrc` file:
141+
```sh
142+
nano ~/.bashrc
143+
```
144+
_(If needed, use `sudo nano ~/.bashrc`)_
145+
146+
2️⃣ Add this line at the **bottom** of the file:
147+
```sh
148+
export PATH="$PATH:$HOME/.config/composer/vendor/bin"
149+
```
150+
151+
3️⃣ Save the file (`CTRL + X`, then `Y`, then `Enter`).
152+
153+
4️⃣ Apply the changes:
154+
```sh
155+
source ~/.bashrc
156+
```
157+
158+
✅ Now, try running `laravelfs` again—it should work! 🚀
159+
160+
---
161+
134162
## **Contributing**
135163
Thank you for considering contributing to LaravelFS! We welcome contributions to improve the installer and keep it updated. Please submit issues and pull requests to the [GitHub repository](https://github.com/HichemTab-tech/LaravelFS).
136164

0 commit comments

Comments
 (0)