Skip to content

Configuration

The LocalProxy can be configured via environment variables and for some options such as token, an argument.

Required

Name Required Description
LOCAL_PROXY_TOKEN true The LocalProxy authentication token. Can also be set as the first arg after running the binary e.g. ./localproxy ${TOKEN}
LOCAL_PROXY_STORAGE_PROVIDER true The LocalProxy storage provider you would like to use. Currently supports AWS. For AWS config, see the AWS section below.

Callback URL

Although not required we recommend setting the LOCAL_PROXY_CALLBACK_URL setting. Depending on the local proxy deployment, the service may not work without this set.

Server

REST Server configuration options.

Name Required Description Default
LOCAL_PROXY_CALLBACK_URL false The host back to the service. This needs to be set if the service is running behind a proxy and cannot be accessed using the host and port set in the server. server_host:server_port
LOCAL_PROXY_SERVER_HOST false The host of the HTTP server that is started. 0.0.0.0
LOCAL_PROXY_SERVER_PORT fasle The port of the HTTP server that is started. 9996
LOCAL_PROXY_SERVER_READ_TIMEOUT false The maximum duration for reading the entire request, including the body. 15s
LOCAL_PROXY_SERVER_WRITE_TIMEOUT false The maximum duration before timing out writes of the response. 15s
LOCAL_PROXY_SERVER_GRACE_PERIOD false The duration to let requests run during shutdown before forcing them to stop. 5s
LOCAL_PROXY_SERVER_CERT_FILE false The path to the cert file. E.g. ./openssl/ca.crt
LOCAL_PROXY_SERVER_KEY_FILE false The path to the key file. E.g. ./openssl/ca.key

Storage

General storage settings. These are not linked to a specific provider.

Name Required Description Default
LOCAL_PROXY_STORAGE_BUCKET_NAME false The name of the bucket snapshots are stored in. nv-snapshots
LOCAL_PROXY_STORAGE_PROVIDER true The LocalProxy storage provider you would like to use. Currently supports AWS. For AWS config, see the AWS section below.

Redaction

Configures what metadata is sent to NerdVision servers.

Name Required Description Default
LOCAL_PROXY_REDACTION_SEND_LOGS false If log messages should be sent to NerdVision servers. This will enable showing logs in the log messages panel. Logs will still appear in the snapshot details without enabling this setting. false
LOCAL_PROXY_REDACTION_SEND_ERROR_MESSAGES false Defines if error_messages should be sent to the NerdVision servers. This will enable showing the error_message in the event lists. Error messages will still appear on the snapshot details page. false

AWS

Allows you to store NerdVision snapshots in AWS S3. You firstly need to set up a bucket for NerdVision snapshots with an IAM user with read/write permissions. Then configure the following:

Name Required Description
AWS_ACCESS_KEY_ID true The AWS Access KeyID for the IAM user.
AWS_SECRET_ACCESS_KEY true The AWS Secret Access Key.
AWS_REGION true The AWS Region for the bucket