# Ubuntu

[**Ubuntu**](https://ubuntu.com/) 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](#method-1-system-settings) and [utilizing the terminal](#method-2-terminal-sessions).

### Method 1: System settings

To set up a system-wide network proxy, follow the steps below:

**Step 1.** [**Download**](https://ubuntu.com/download/desktop) and install Ubuntu Desktop.

**Step 2.** Find **Settings** from the Ubuntu launcher and go to the **Network** tab.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2FbDYJnF1S6PKLhmBg1kU5%2Fimage.png?alt=media&#x26;token=aa0a5b5a-f669-4b8d-975e-2375995248ee" alt="Ubuntu launcher"><figcaption></figcaption></figure>

**Step 3.** Once you click on **Network**, it will open up a new dialog. From the three options, choose **Network Proxy.**

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2F0QpbIwlPPRIdIB3jYFza%2Fimage.png?alt=media&#x26;token=e78a2185-2744-409b-9ae8-5f0307963093" alt="Choose Network Proxy"><figcaption></figcaption></figure>

**Step 4.** Select **Manual** to configure proxy settings. Next, several text boxes will pop up from which you can set `HTTP` or `SOCKS` proxy. Fill in the following information:&#x20;

**HTTP Proxy:** a specific IP address (`192.168.1.100` - example)

{% hint style="info" %}
In the case of Dedicated Datacenter Proxies, you will need to choose an IP address from the purchased list. Please refer to our [**`documentation`**](broken://pages/gReH6YgcRO0a2E34h5i4) for more details.
{% endhint %}

**Port:** `60000`

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2Fj415y9XFS32RYS9BaV9H%2Fimage.png?alt=media&#x26;token=7d2e8572-e17e-484a-87ba-4d1022b7ad76" alt="Configuring proxy" width="563"><figcaption></figcaption></figure>

**Step 5.** Close the Network Proxy window. The changes will automatically be saved, and the system-wide proxy will be activated.&#x20;

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.

***

### Method 2: Terminal sessions

To set up a network proxy for all terminal sessions, follow the steps below:

**Step 1.** [**Download**](https://ubuntu.com/download/desktop) 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:

```sh
vim ~/.zshrc
```

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 two new environment variables

At the bottom of this configuration file, you’ll have to define the `http_proxy` or `ALL_PROXY` (for SOCKS5) variables. You'll need to use a specific IP address from your proxy list. For demonstration, let's use `192.168.1.100:60000`:

```sh
export http_proxy="USERNAME:PASSWORD@192.168.1.100:60000"
export ALL_PROXY="socks5://USERNAME:PASSWORD@192.168.1.100:60000"
```

Here are the details you need to fill in:

**Proxy address:** a specific IP address (`192.168.1.100` - example)

**Port:** `60000`

**Username:** `username`

**Password:** `password`

**Step 4.** Reload the configuration

Now, you can reload the configuration file either by opening a new terminal or by running the following command in the existing terminal:

```sh
source ~/.zshrc
```

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.&#x20;

You can find the complete tutorial [here](https://oxylabs.io/resources/integrations/ubuntu).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/integrations/proxy-integrations/dedicated-datacenter-proxies-guides/enterprise/ubuntu-gui.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.