Skip to main content

Updating QuikDB CLI

Automatic Update​

macOS/Linux:

sudo quikdb update

Windows (Run as Administrator):

quikdb update

Manual Update​

If automatic update fails:

macOS Apple Silicon:

sudo rm /usr/local/bin/quikdb
curl -L https://docs.quikdb.com/downloads/quikdb-darwin-arm64.tar.gz | tar xz
sudo mv quikdb /usr/local/bin/ && sudo chmod +x /usr/local/bin/quikdb

macOS Intel:

sudo rm /usr/local/bin/quikdb
curl -L https://docs.quikdb.com/downloads/quikdb-darwin-amd64.tar.gz | tar xz
sudo mv quikdb /usr/local/bin/ && sudo chmod +x /usr/local/bin/quikdb

Linux:

sudo rm /usr/local/bin/quikdb
curl -L https://docs.quikdb.com/downloads/quikdb-linux-amd64.tar.gz | tar xz
sudo mv quikdb /usr/local/bin/ && sudo chmod +x /usr/local/bin/quikdb

Windows:

Remove-Item -Force "$env:ProgramFiles\QuikDB\quikdb.exe" -ErrorAction SilentlyContinue
Invoke-WebRequest -Uri "https://docs.quikdb.com/downloads/quikdb-windows-amd64.zip" -OutFile "$env:TEMP\quikdb.zip"
Expand-Archive -Path "$env:TEMP\quikdb.zip" -DestinationPath "$env:ProgramFiles\QuikDB" -Force

Or download directly: Windows | Mac Intel | Mac ARM | Linux

Troubleshooting​

Windows: "The process cannot access the file because it is being used by another process"​

If quikdb update fails on Windows with this error, the CLI cannot replace itself while running. Use one of these solutions:

  1. FIRST: Find where QuikDB is actually installed

    Open PowerShell and run: where quikdb

    • If it shows a path (e.g., C:\Users\YourName\AppData\Local\QuikDB\quikdb.exe):

      • That's the file you need to replace!
      • Continue to step 2

    • If where quikdb shows nothing:

      • QuikDB is not in your PATH
      • Find it manually: Get-ChildItem -Path C:\Users\$env:USERNAME -Recurse -Filter quikdb.exe -ErrorAction SilentlyContinue | Select-Object FullName
      • Common locations:
        • C:\Users\<YourUsername>\AppData\Local\QuikDB\quikdb.exe
        • C:\Program Files\QuikDB\quikdb.exe
        • Current directory where you installed it
      • OR: Check where you're running it from - if you type .\quikdb --version it's in your current directory

  2. Download: quikdb-windows-amd64.zip

  3. Extract the zip file (right-click → Extract All)

  4. Close ALL PowerShell/terminal windows

  5. Replace the file:

    • Navigate to the path from step 1
    • Replace quikdb.exe with the extracted file
    • If Windows says "file is in use", close ALL terminals and try again

  6. Open a FRESH PowerShell window

  7. Verify the update:

    • If QuikDB is in PATH: quikdb --version
    • If not in PATH: Navigate to the directory and run .\quikdb --version
    • Should show version 1.5.5

Still showing old version after replacing the file?

The file may not have been replaced properly. Try:

# Force delete and replace (run as Administrator if needed)
$quikPath = "C:\Users\$env:USERNAME\AppData\Local\QuikDB\quikdb.exe"  # Adjust this path
Remove-Item $quikPath -Force
# Then extract and copy the new quikdb.exe to that location

Option 2: PowerShell One-Liner​

Close the current terminal, then open a new PowerShell window and run:

$url = "https://docs.quikdb.com/downloads/quikdb-windows-amd64.zip"
$temp = "$env:TEMP\quikdb-update"
$installPath = "$env:LOCALAPPDATA\QuikDB\quikdb.exe"
Invoke-WebRequest -Uri $url -OutFile "$temp.zip"
Expand-Archive -Path "$temp.zip" -DestinationPath $temp -Force
Copy-Item "$temp\quikdb.exe" $installPath -Force
Remove-Item -Path "$temp*" -Recurse -Force
Write-Host "✅ Update complete! Run: quikdb --version" -ForegroundColor Green

Verify​

quikdb --version