Install Windsurf on Ubuntu
January 22, 2025 ยท AI Conversations
### 1. **Navigate to the directory**
Open a terminal and navigate to the directory containing the `.tar.gz` file:
cd /path/to/Windsurf-linux-x64-1.2.1.tar.gz
### 2. **Extract the file**
Use the `tar` command to extract the `.tar.gz` file:
tar -xvzf Windsurf-linux-x64-1.2.1.tar.gz
This will create a new folder in the same directory, typically named something like `Windsurf-linux-x64-1.2.1`.
### 3. **Navigate to the extracted folder**
cd Windsurf-linux-x64-1.2.1
### 4. **Look for installation instructions**
Check if the extracted folder contains a `README` or `INSTALL` file with specific instructions. Use a text editor or `cat` to read them:
cat README
cat INSTALL
### 5. **Run the installer or binary**
If there is an executable file (e.g., `install.sh` or the binary itself), run it. For example:
– **For an install script**:
chmod +x install.sh
./install.sh
– **For a direct executable binary**:
chmod +x windsurf
./windsurf
### 6. **Move the binary to a global location (Optional)**
To make the program accessible system-wide, move the executable to a directory in your PATH (e.g., `/usr/local/bin`):
sudo mv windsurf /usr/local/bin/
Now you can run it from anywhere using:
windsurf
### 7. **Verify installation**
If the installation completes successfully, verify by running:
windsurf --version
If the program requires additional dependencies or configurations, the `README` or other documentation in the extracted folder should provide guidance. Let me know if you encounter issues!
windsurf: error while loading shared libraries: libffmpeg.so: cannot open shared object file: No such file or directory
—
### 1. **Locate `libffmpeg.so` in the WindSurf Directory**
First, check if `libffmpeg.so` is included in the extracted WindSurf directory.
find ~/Windsurf-linux-x64-1.2.1 -name libffmpeg.so
If the file is found:
– Add its directory to the `LD_LIBRARY_PATH` so WindSurf can locate it:
export LD_LIBRARY_PATH=/path/to/libffmpeg:$LD_LIBRARY_PATH
– Replace `/path/to/libffmpeg` with the actual path where `libffmpeg.so` is located.
—
### 2. **Install `libffmpeg.so`**
If `libffmpeg.so` is not included, you can install it manually.
#### A. **For Ubuntu using Snap**
Install the required libraries via Snap:
sudo snap install ffmpeg
#### B. **For Ubuntu using apt**
Alternatively, install `ffmpeg` using apt:
sudo apt update
sudo apt install ffmpeg
#### C. **Manually Download `libffmpeg.so`**
If `libffmpeg.so` is a specific version not included with the system, download it manually:
1. Download the required library from the [FFmpeg GitHub](https://github.com/BtbN/FFmpeg-Builds/releases).
2. Extract and place the `libffmpeg.so` file in `/usr/lib` or `/usr/local/lib`:
sudo cp libffmpeg.so /usr/lib/
3. Update the library cache:
sudo ldconfig
—
### 3. **Verify Library Linkage**
Ensure that WindSurf is correctly linked to `libffmpeg.so`:
ldd $(which windsurf)
Look for `libffmpeg.so`. If it's still showing "not found," ensure the path to `libffmpeg.so` is in the `LD_LIBRARY_PATH` or move the file to a standard library location (`/usr/lib`).
—
### 4. **Retry Running WindSurf**
Now, retry running the application:
windsurf --version
Let me know if this resolves the issue or if you encounter additional errors!