Proxy configuration

This tutorial shows you how to configure your system for use behind an outbound proxy to access the Internet.

Clear Linux OS applications already benefit from the Autoproxy feature.


This tutorial assumes you have installed Clear Linux OS on your host system. For detailed instructions on installing Clear Linux OS on a bare metal system, visit the bare metal installation guide.

Shells and programs in a desktop session


Add the following to your ~/.bashrc:

export http_proxy=http://your.http-proxy.url:port
export https_proxy=http://your.https-proxy.url:port
export ftp_proxy=http://your.ftp-proxy.url:port
export socks_proxy=http://your.socks-proxy.url:port
export no_proxy=",localhost"
export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$https_proxy
export FTP_PROXY=$ftp_proxy
export SOCKS_PROXY=$socks_proxy
export NO_PROXY=$no_proxy


Run this command to enable downloading from websites from the terminal:

echo >> ~/.wgetrc <<EOF
http_proxy = your.http-proxy.url:port
https_proxy = your.https-proxy.url:port
ftp_proxy = your.http-proxy.url:port
no_proxy =, localhost

System service (Docker)

For Docker (and other services that use systemd), you can follow these steps to configure and check proxy settings:


Be sure to use sudo, as you will need elevated permissions.

  1. Create /etc/systemd/system/docker.service.d directory to host configuration information for the Docker service.

  2. Create /etc/systemd/system/docker.service.d/http-proxy.conf and add:

  3. Load the changes and restart the service:

    sudo systemctl daemon-reload
    sudo systemctl restart docker
  4. Verify that changes have loaded:

    systemctl show --property=Environment docker
    Environment=HTTP_PROXY=http://your.http-proxy.url:port/ HTTPS_PROXY=http://your.https-proxy.url:port/


This process enables the ability to successfully run docker pull. Containers themselves must be configured independently.

git over ssh

Add the following to your ~/.ssh/config:

    port 22
    user git
    ProxyCommand connect-proxy -S your.ssh-proxy.url:port %h %p


Though netcat is included with Clear Linux, it is not the BSD version, which is the one usually used to enable git over ssh.