Skip to main content

Install in code-server

code-server runs VS Code in the browser, allowing remote development. VSIX installation is required.

Prerequisites​

  • code-server installed and running
  • Access to upload files to the server (SSH, SCP, etc.)

Download the Extension​

Download the VSIX file to your server:

Download SF Veritas VSIX from Open VSX

Transfer to Server​

# Using SCP
scp sf-veritas-extension-x.x.x.vsix user@server:/home/user/

# Or using rsync
rsync -av sf-veritas-extension-x.x.x.vsix user@server:/home/user/

Installation Steps​

SSH into your server and run:

code-server --install-extension /path/to/sf-veritas-extension-x.x.x.vsix

Then restart code-server:

# If using systemd
sudo systemctl restart code-server

# Or manually restart the process

Method 2: Browser UI​

  1. Open code-server in your browser
  2. Open the Extensions view (Ctrl+Shift+X)
  3. Click the ... menu
  4. Select "Install from VSIX..."
  5. Navigate to the VSIX file location on the server

Verify Installation​

  1. Refresh code-server in your browser
  2. Look for the SF Veritas icon in the Activity Bar
  3. Open the Command Palette (Ctrl+Shift+P)
  4. Verify "SF Veritas" commands are available

Configuration​

Server Port Considerations​

The SF Veritas local server runs on port 6776 by default. In a remote environment:

  1. Ensure port 6776 is available on the server
  2. If needed, change the port in settings: 
    {
      "sfVeritas.localServerPort": 6777
    }

Data Storage​

The SQLite database will be created at ~/.sf-veritas/telemetry.db on the server.

Troubleshooting​

Extension not appearing after installation​

  1. Fully restart code-server (not just browser refresh)
  2. Check code-server logs for extension loading errors
  3. Verify the VSIX file was correctly uploaded

Cannot connect instrumented applications​

When your application runs on a different machine:

  1. Configure the application to send telemetry to the code-server host
  2. Ensure firewall allows connections on port 6776

Next Steps​