Ubuntu
Configure Ubuntu with Oxylabs Proxies using GNOME settings or terminal. Step-by-step guide for system-wide proxy setup.
Ubuntu is an open-source software operating system on Linux for enterprise servers, desktops, the cloud, and IoT.
There are multiple ways to set up a proxy server for Ubuntu. In this guide, you'll find two common methods: using System (GNOME) settings and utilizing the terminal. for the following Oxylabs proxy types:
Residential & Mobile Proxies
Datacenter Proxies
Dedicated Datacenter Proxies (Enterprise)
Dedicated Datacenter Proxies (Self-service)
ISP Proxies
Dedicated ISP Proxies
Method 1: System settings
To set up a system-wide network proxy, follow the steps below:
Step 1
Download and install Ubuntu Desktop.
Step 2
Find Settings from the Ubuntu launcher and go to the Network tab.
Step 3
Once you click on Network, it will open up a new dialog. From the three options, choose Network Proxy.
Step 4
Select Manual to configure proxy settings. Next, several text boxes will pop up from which you can set HTTP, HTTPS, or SOCKS proxy. Fill in the details for your chosen proxy type:
Residential & Mobile Proxies
Available protocols: HTTP, HTTPS, SOCKS5
Host/IP: pr.oxylabs.io
Port: 7777
You may also use additional parameters with residential and mobile proxies to set the geo-location (country, state, city, and etc.) and control sessions. Check out the Residential Proxies documentation to learn more.
Datacenter Proxies
Available protocols: HTTP, HTTPS, SOCKS5
Host/IP: dc.oxylabs.io
Port: 8001
The port is the sequential number assigned to an IP address from the proxy list. Thus, port 8001 uses the first IP address from your list. You may also enable proxy IP rotation by setting the port to 8000.
Furthermore, you can specify the geo-location, for example, the US, by setting the Proxy username to user-USERNAME-country-US.
The port 8001 picks a random IP address but stays consistent during a session. Alternatively, you can rotate proxy IPs with each request by using port 8000.
If you want to use a specific geo-location, for example, the US, set the Proxy username to user-USERNAME-country-US.
Dedicated Datacenter Proxies (Enterprise)
Available protocols: HTTP, SOCKS5
Host/IP: 1.2.3.4 (IP address from your proxy list)
Port: 60000 (HTTP) or 1180 (SOCKS5)
For Enterprise Dedicated Datacenter Proxies (purchased via sales), you’ll have to choose an IP address from the acquired proxy list.
Dedicated Datacenter Proxies (Self-service)
Available protocols: HTTP, HTTPS, SOCKS5
Host/IP: ddc.oxylabs.io
Port: 8001
For Self-Service Dedicated Datacenter Proxies (purchased via Oxylabs dashboard), the port indicates the sequential number of an IP address from the acquired proxy list. If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.
ISP Proxies
Available protocols: HTTP, HTTPS, SOCKS5
Host/IP: isp.oxylabs.io
Port: 8001
ISP Proxies assign each port to a specific IP address and location. Port 8001 always uses the first IP from your proxy list. Use port 8000 to enable proxy rotation.
To get rotating IPs from a specific country's proxy pool, set the username using this format: user-USERNAME-country-XX, where XX is the country code (e.g., US for United States).
Dedicated ISP Proxies
Available protocols: HTTP, HTTPS, SOCKS5
Host/IP: disp.oxylabs.io
Port: 8001
You will need to choose the port assigned to an IP address from the purchased proxy list, which you can find on the Oxylabs dashboard. The 8001 port will pick the first IP address from your list for all requests. Use port 8000 for automatic proxy IP rotation.
Step 5
Close the Network Proxy window. The changes will automatically be saved, and the system-wide proxy will be activated.
Each time you make a web request through a browser or other application, a pop-up window will prompt you to enter the credentials of your Oxylabs proxy user for the session. Enter corresponding proxy credentials (created via Oxylabs dashboard):
Residential & Mobile proxies
User Name: customer-USERNAME
Password: PASSWORD
Datacenter proxies
User Name: user-USERNAME
Password: PASSWORD
Dedicated Datacenter proxies (Enterprise)
User Name: USERNAME
Password: PASSWORD
Dedicated Datacenter proxies (Self-service)
User Name: user-USERNAME
Password: PASSWORD
ISP proxies
User Name: user-USERNAME
Password: PASSWORD
Dedicated ISP proxies
User Name: user-USERNAME
Password: PASSWORD
Make sure to add the customer- or user- prefix to your username if your proxy type requires it.
Method 2: Terminal sessions
To set up a network proxy for all terminal sessions, follow the steps below:
Step 1
Download and install Ubuntu Desktop.
Step 2
Open shell configuration using an editor. For the ZSH terminal, the shell configuration file is by default located in the home directory. We can edit this file using vim with the below command:
Instead of vim, you can also use gedit, nano, or any other text editor that you prefer. Also, if you are using Bash instead of ZSH, you’ll have to edit your bash shell configuration file, i.e. ~/.bashrc instead of ~/.zshrc.
Step 3
Create new environment variables. At the bottom of this configuration file, you’ll have to define the http_proxy, https_proxy, or ALL_PROXY (for SOCKS5) variables.
Then adjust the details for your chosen proxy type:
Residential & Mobile Proxies
Host: pr.oxylabs.io
Port: 7777
Username: customer-username
Password: password
Don't forget to add the customer- part to your username.
You may also use additional parameters with residential and mobile proxies to set the geo-location (country, state, city, and etc.) and control sessions. Check out the Residential Proxies documentation to learn more.
Datacenter Proxies
Host: dc.oxylabs.io
Port: 8001
Username: user-username
Password: password
Don't forget to add the user- part to your username.
The port is the sequential number assigned to an IP address from the proxy list. Thus, port 8001 uses the first IP address from your list. You may also enable proxy IP rotation by setting the port to 8000.
Furthermore, you can specify the geo-location, for example, the US, by setting the Proxy username to user-USERNAME-country-US.
The port 8001 picks a random IP address but stays consistent during a session. Alternatively, you can rotate proxy IPs with each request by using port 8000.
If you want to use a specific geo-location, for example, the US, set the Proxy username to user-USERNAME-country-US.
Dedicated Datacenter Proxies (Enterprise)
Host: 1.2.3.4 (IP address from your proxy list)
Port: 60000 (HTTP), 1180 (SOCKS5)
Username: username
Password: password
For Enterprise Dedicated Datacenter Proxies (purchased via sales), you’ll have to choose an IP address from the acquired proxy list.
Dedicated Datacenter Proxies (Self-service)
Host: ddc.oxylabs.io
Port: 8001
Username: user-username
Password: password
Don't forget to add the user- part to your username.
For Self-Service Dedicated Datacenter Proxies (purchased via Oxylabs dashboard), the port indicates the sequential number of an IP address from the acquired proxy list. If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.
ISP Proxies
Host: isp.oxylabs.io
Port: 8001
Username: user-username
Password: password
Don't forget to add the user- part to your username.
ISP Proxies assign each port to a specific IP address and location. Port 8001 always uses the first IP from your proxy list. Use port 8000 to enable proxy rotation.
To get rotating IPs from a specific country's proxy pool, set the username using this format: user-USERNAME-country-XX, where XX is the country code (e.g., US for United States).
Dedicated ISP Proxies
Host: disp.oxylabs.io
Port: 8001
Username: user-username
Password: password
Don't forget to add the user- part to your username.
You will need to choose the port assigned to an IP address from the purchased proxy list, which you can find on the Oxylabs dashboard. The 8001 port will pick the first IP address from your list for all requests. Use port 8000 for automatic proxy IP rotation.
Step 4
Reload the configuration file either by opening a new terminal or by running the following command in the existing terminal:
The proxy will always be active for the current user. The shell configuration file gets loaded every time you open a new terminal. So, the environment variables will be always available for you even if you restart your computer.
If you want to enable it for all users then you will have to append the above two lines in the /etc/environment.
That’s all! You’ve successfully integrated your Oxylabs proxies.
You can find the complete tutorial here.
Last updated
Was this helpful?