[GH-ISSUE #887] [Bug] Need more instructions in documentation for Building in Ubuntu #350

New issue

Closed

opened 2026-03-23 20:35:45 +00:00 by mirror · 2 comments

mirror commented

2026-03-23 20:35:45 +00:00

Owner

Originally created by @IMPranshu on GitHub (Aug 22, 2022).
Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/887

I faced a few issues while building in Ubuntu 20.04. Until 3rd step of the instruction everything went smooth.

Start following the instruction for building from source in Ubuntu 20.04. You might encounter this error in the 3rd step.

Well, this is not exactly a bug of the software but just an environmental issue of your local machine.

You might have encountered this warning while following the previous steps

Also if you just scroll and inspect exactly why the build is failing and the solution to this as well.

So just run the following command in the terminal before following the 3rd step and you are ready to build.

export PATH="$PATH":"$HOME/.pub-cache/bin"

Also while following the 4th step you might encounter this error.

No such file or directory

Just relax it is not an issue you just have to change the version from 0.0.2 to 0.0.4 that you build recently in the following command

cd app_flowy/product/0.0.4/linux/Debug/AppFlowy

If all goes well you can expect to run the AppFlowy that you just built successfully in your local Ubuntu 20.04 machine and get this screen and start working with it.

OS: Ubuntu 20.04
Version- 0.0.4

Originally created by @IMPranshu on GitHub (Aug 22, 2022). Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/887 I faced a few issues while building in Ubuntu 20.04. Until [3rd step](https://appflowy.gitbook.io/docs/essential-documentation/contribute-to-appflowy/software-contributions/environment-setup/building-on-linux#step-3-build-appflowy-flutter-gui-application) of the instruction everything went smooth. Start following the instruction for building from source in Ubuntu 20.04. You might encounter this error in the 3rd step. ![image](https://user-images.githubusercontent.com/43396684/185847849-af56931e-15c2-47ba-9078-0436a1e30825.png) Well, this is not exactly a bug of the software but just an environmental issue of your local machine. You might have encountered this `warning` while following the previous steps ![image](https://user-images.githubusercontent.com/43396684/185847999-7416b67b-de27-4c8c-bc38-d3089cae52a4.png) Also if you just scroll and inspect exactly why the build is failing and the solution to this as well. ![image](https://user-images.githubusercontent.com/43396684/185848175-5b211e5d-8404-4555-be09-93cc9f46131f.png) So just run the following command in the terminal before following the 3rd step and you are ready to build. `export PATH="$PATH":"$HOME/.pub-cache/bin"` Also while following the [4th step](https://appflowy.gitbook.io/docs/essential-documentation/contribute-to-appflowy/software-contributions/environment-setup/building-on-linux#step-4-run-the-application) you might encounter this error. `No such file or directory` Just relax it is not an issue you just have to change the version from `0.0.2 to 0.0.4` that you build recently in the following command `cd app_flowy/product/0.0.4/linux/Debug/AppFlowy` If all goes well you can expect to run the AppFlowy that you just built successfully in your local Ubuntu 20.04 machine and get this screen and start working with it. ![image](https://user-images.githubusercontent.com/43396684/185849083-78b55abf-3618-4e8f-9e3e-99a0efd3819c.png) - OS: Ubuntu 20.04 - Version- 0.0.4

mirror closed this issue

2026-03-23 20:35:45 +00:00

mirror commented

2026-03-23 20:35:45 +00:00

Author

Owner

@ChiragKr04 commented on GitHub (Aug 24, 2022):

Hi.
So I checked the same issue.

The fix will go something like this:

Go to file explorer or Files in Ubuntu.
Now go to the Home tab and enable the button to show all hidden files.
Now you will see all your hidden files.
Now open 2 files, .profile and .bashrc.
Go to the end of these files and paste export PATH="$PATH":"$HOME/.pub-cache/bin" this.
Now save both files
Logout and log in again and build again.
It will build and the app will be running smoothly.

Here is a screenshot running on Ubuntu 22.04.1 LTS

@ChiragKr04 commented on GitHub (Aug 24, 2022): Hi. So I checked the same issue. The fix will go something like this: 1. Go to file explorer or `Files` in Ubuntu. 2. Now go to the `Home` tab and enable the button to show all hidden files. 3. Now you will see all your hidden files. 4. Now open 2 files, `.profile` and `.bashrc`. 5. Go to the end of these files and paste `export PATH="$PATH":"$HOME/.pub-cache/bin"` this. 6. Now save both files 7. Logout and log in again and build again. 8. It will build and the app will be running smoothly. Here is a screenshot running on `Ubuntu 22.04.1 LTS` ![image](https://user-images.githubusercontent.com/62651867/186386550-9271d984-5dcd-432b-8641-76cd53f11803.png)

mirror commented

2026-03-23 20:35:46 +00:00

Author

Owner

@rileyhawk1417 commented on GitHub (Jan 23, 2025):

Currently there is updated documentation for this: https://docs.appflowy.io/docs/documentation/appflowy/from-source/environment-setup/building-on-linux

So am closing this issue.

@rileyhawk1417 commented on GitHub (Jan 23, 2025): Currently there is updated documentation for this: https://docs.appflowy.io/docs/documentation/appflowy/from-source/environment-setup/building-on-linux So am closing this issue.