neko/webpage/docs/getting-started/v2-migration

sidebar_position
8

V2 Migration Guide

Configuration

V3 is compatible with V2 configuration options when legacy support is enabled. You should be able to run V3 with the V2 configuration without any issues.

The configuration in Neko V3 has been structured differently compared to V2. The V3 configuration is more modular and allows for more flexibility. The V3 configuration is split into multiple sections, each section is responsible for a specific part of the application. This allows for better organization and easier management of the configuration.

In order to migrate from V2 to V3, you need to update the configuration to the new format. The following table shows the mapping between the V2 and V3 configuration options.

V2 Configuration	V3 Configuration
NEKO_LOGS removed	NEKO_LOG_DIR=/path/to/logs
NEKO_CERT	NEKO_SERVER_CERT
NEKO_KEY	NEKO_SERVER_KEY
NEKO_BIND	NEKO_SERVER_BIND
NEKO_PROXY	NEKO_SERVER_PROXY
NEKO_STATIC	NEKO_SERVER_STATIC
NEKO_PATH_PREFIX	NEKO_SERVER_PATH_PREFIX
NEKO_CORS	NEKO_SERVER_CORS
NEKO_LOCKS	NEKO_SESSION_LOCKED_CONTROLS and NEKO_SESSION_LOCKED_LOGINS, V3 allows separate locks for controls and logins
NEKO_IMPLICIT_CONTROL	NEKO_SESSION_IMPLICIT_HOSTING
NEKO_CONTROL_PROTECTION	NEKO_SESSION_CONTROL_PROTECTION
NEKO_HEARTBEAT_INTERVAL	NEKO_SESSION_HEARTBEAT_INTERVAL

See the V3 configuration options.

WebRTC Video

See the V3 configuration options for the WebRTC Video.

V2 Configuration	V3 Configuration
NEKO_DISPLAY	NEKO_CAPTURE_VIDEO_DISPLAY and NEKO_DESKTOP_DISPLAY, consider using DISPLAY env variable if both should be the same
NEKO_VIDEO_CODEC	NEKO_CAPTURE_VIDEO_CODEC
NEKO_AV1=true deprecated	NEKO_CAPTURE_VIDEO_CODEC=av1
NEKO_H264=true deprecated	NEKO_CAPTURE_VIDEO_CODEC=h264
NEKO_VP8=true deprecated	NEKO_CAPTURE_VIDEO_CODEC=vp8
NEKO_VP9=true deprecated	NEKO_CAPTURE_VIDEO_CODEC=vp9
NEKO_VIDEO	NEKO_CAPTURE_VIDEO_PIPELINE, V3 allows multiple video pipelines
NEKO_VIDEO_BITRATE	removed, use custom pipeline instead
NEKO_HWENC	removed, use custom pipeline instead
NEKO_MAX_FPS	removed, use custom pipeline instead

:::warning V2 did not have client-side cursor support, the cursor was always part of the video stream. In V3, the cursor is sent separately from the video stream. Therefore, when using legacy configuration, there will be two video streams created, one with the cursor (for V2 clients) and one without the cursor (for V3 clients). Please consider using new configuration options if this is not the desired behavior. :::

WebRTC Audio

See the V3 configuration options for the WebRTC Audio.

V2 Configuration	V3 Configuration
NEKO_DEVICE	NEKO_CAPTURE_AUDIO_DEVICE
NEKO_AUDIO_CODEC	NEKO_CAPTURE_AUDIO_CODEC
NEKO_G722=true deprecated	NEKO_CAPTURE_AUDIO_CODEC=g722
NEKO_OPUS=true deprecated	NEKO_CAPTURE_AUDIO_CODEC=opus
NEKO_PCMA=true deprecated	NEKO_CAPTURE_AUDIO_CODEC=pcma
NEKO_PCMU=true deprecated	NEKO_CAPTURE_AUDIO_CODEC=pcmu
NEKO_AUDIO	NEKO_CAPTURE_AUDIO_PIPELINE
NEKO_AUDIO_BITRATE	removed, use custom pipeline instead

Broadcast

See the V3 configuration options for the Broadcast.

V2 Configuration	V3 Configuration
NEKO_BROADCAST_PIPELINE	NEKO_CAPTURE_BROADCAST_PIPELINE
NEKO_BROADCAST_URL	NEKO_CAPTURE_BROADCAST_URL
NEKO_BROADCAST_AUTOSTART	NEKO_CAPTURE_BROADCAST_AUTOSTART

Desktop

See the V3 configuration options for the Desktop.

V2 Configuration	V3 Configuration
NEKO_SCREEN	NEKO_DESKTOP_SCREEN

Authentication

See the V3 configuration options for the Authentication.

V2 Configuration	V3 Configuration
NEKO_PASSWORD	NEKO_MEMBER_MULTIUSER_USER_PASSWORD with NEKO_MEMBER_PROVIDER=multiuser
NEKO_PASSWORD_ADMIN	NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD with NEKO_MEMBER_PROVIDER=multiuser

In order for the legacy authentication to work, you need to set Multi-user.

:::warning V2 clients might not be compatible with any other authentication provider than the multiuser. :::

WebRTC

See the V3 configuration options for the WebRTC.

V2 Configuration	V3 Configuration
NEKO_NAT1TO1	NEKO_WEBRTC_NAT1TO1
NEKO_TCPMUX	NEKO_WEBRTC_TCPMUX
NEKO_UDPMUX	NEKO_WEBRTC_UDPMUX
NEKO_ICELITE	NEKO_WEBRTC_ICELITE
NEKO_ICESERVERS or NEKO_ICESERVER	NEKO_WEBRTC_ICESERVERS_FRONTEND and NEKO_WEBRTC_ICESERVERS_BACKEND, V3 allows separate ICE servers for frontend and backend
NEKO_IPFETCH	NEKO_WEBRTC_IP_RETRIEVAL_URL
NEKO_EPR	NEKO_WEBRTC_EPR

Full V2 Configuration Reference

Here is a full list of all the configuration options available in Neko V2 that are still available in Neko V3 with legacy support enabled.

import Configuration from '@site/src/components/Configuration'; import configOptions from './help.json';

See the full V3 configuration reference for more details.