How to Assign or Remove a Public IP Address

Machines are Linux and Windows virtual machines with persistent storage, GPU options, and free unlimited bandwidth. They’re designed for high-performance computing (HPC) workloads.

For a machine to be accessible over the internet, it needs a public IP address. You can assign either a static or dynamic public IP address:

• A machine with a static public IP address has the same IP address every time it powers on. Static public IP addresses remain in your Paperspace account until you delete them.

  We recommend static addresses when you need a consistent address to access your machine.

• A machine with a dynamic public IP address has a different IP address each time it powers on. Dynamic public IP addresses are assigned automatically when a machine powers on and deleted when it powers off.

  We recommend dynamic addresses when you only need temporary access to your machine.

A machine with no public IP address is not accessible over the internet, which is suitable for some use cases and avoids unnecessary charges. However, SSH-only machines must have a public IP address in order to use them.

You can manage a public IP address using the Paperspace console, Paperspace API, or Paperspace CLI.

Assign a Static Public IP Address

Using the Paperspace Console

To assign a static IP address, go to the Paperspace console, in the top-right corner, click the dropdown menu, select CORE, then click the Machines tab.

In the Machines section, select the machine you want to assign a static IP address to. On the machine’s overview page, in the top-right corner, click the Settings tab.

In the Settings page, under the Public IP section, click Static, then click SAVE to open the Make public IP static window.

On the Make public IP static window, click ASSIGN IP if you want to create a static public IP address. If you create a static IP address, you are charged for that IP address until you delete it.

Afterwards, your machine is automatically assigned a static public IP address, which is shown in the Settings page, under the Public IP section.

Using the Paperspace API

Before assigning a static public IP address using the Paperspace API, you first need to claim an IP address and attach it to your Paperspace account. Afterwards, copy the public IP address you’ve claimed for later use.

To assign a static public IP address, provide the following values:

• ip (string): The static public IP address you want to assign to your machine.
• machineId (string): The ID of the machine you want to assign a static public IP address to.

curl -X PUT \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PAPERSPACE_API_KEY" \
  -d '{
        "ip": "203.0.113.0",
        "machineId": "psm9u09bwu5i"
      }' \
  "https://api.paperspace.com/v1/public-ips/203.0.113.0"

Using the Paperspace CLI

Before assigning a static public IP address using the Paperspace CLI, you first need to claim a public IP address and attach it to your Paperspace account. Afterwards, copy the public IP address you’ve claimed for later use.

To assign a static public IP address, provide the following values:

• ip (string): The static public IP address you want to assign to your machine.
• machine-id (string): The ID of the machine you want to assign a static public IP address to.

pspace login --api-key your-api-key

pspace public-ip assign 203.0.113.0 -F --machine-id psm9u09bwu5i

Assign a Dynamic Public IP Address

Note

You cannot use the Paperspace API or CLI to assign a dynamic IP address to existing machines. You can only specify the type of IP address when you first create your machine. If you want to assign a dynamic IP address to existing machines, you can assign them via the Paperspace console.

To assign a dynamic IP address, go to the Paperspace console, in the top-right corner, click the dropdown menu, select CORE, then click the Machines tab.

In the Machines section, select the machine you want to assign a dynamic IP address to. On the machine’s overview page, in the top-right corner, click the Settings tab.

In the Settings page, under the Public IP section, click Dynamic, then click SAVE to open the Make public IP dynamic window.

On the Make public IP dynamic window, click ASSIGN IP if you want to create a dynamic public IP address. If you create a dynamic public IP address, you’re only charged when you’re using your machine.

Afterwards, your machine is automatically assigned a dynamic public IP address, which is shown in the Settings page, under the Public IP section.

Remove Public IP Address

Using the Paperspace Console

To remove an IP address, go to the Paperspace console, in the top-right corner, click the dropdown menu, select CORE, then click the Machines tab.

In the Machines section, select the machine you want to remove a IP address for. On the machine’s overview page, in the top-right corner, click the Settings tab.

In the Settings page, under the Public IP section, click None, then click SAVE to open the Remove public IP window.

On the Remove public IP window, click REMOVE IP if you want to remove the IP address assigned to your machine. If you remove the public IP address associated with your machine, then your machine isn’t reachable over the internet.

Using the Paperspace API

When removing a public IP address using the Paperspace API, you need to provide the public IP address to remove.

curl -X DELETE \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PAPERSPACE_API_KEY" \
  -d '{
        "ip": "203.0.113.0"
      }' \
  "https://api.paperspace.com/v1/public-ips/203.0.113.0"

Using the Paperspace CLI

When removing a static public IP address using the Paperspace CLI, you need to provide the public IP address to remove.

pspace login --api-key your-api-key

pspace public-ip release 203.0.113.0