SIM-Based Routing

To access a device on the subnet beyond to your cellular router, it used to be necessary to spend extra effort configuring network settings like port forwarding and tunnels for that router. With SIM-based routing, you can link the SIM card in that router and the router's Local Area Network (LAN) IP range. This allows the SIM itself to be set as the routing destination when using Soracom Gate, reducing the time and cost of network maintenance for inter-site connection equipment and IoT gateways.

SIM-Based Routing

SIM-Based Routing is a free feature that is included with the cost of your VPG.


Before enabling SIM-Based Routing, ensure that you have completed the following:

Router Settings

To use SIM-based routing, the cellular router must be able to forward the packets received from Soracom to the devices connected to the router's Local Area Network (LAN). For our configuration guide, we will show how to enable the neccessary settings on a Teltonika RUT240 cellular router. However, SIM-Based routing will work with any router capable of packet forwarding and receiving packets from the cellular network.

  1. Log in to the RUT240's web interface. By default, this can be reached by navigating to

  2. Click the System tab, then under the Setup Wizard header select LAN.

    Set the RUT240's LAN IP address to and the DHCP IP address range to to

    IP Configuration

  3. If the RUT240 is in "Basic" mode, click Mode to change it to "Advanced" mode.


  4. Click the Network tab, then under the Firewall header select General Settings.

    General Settings

  5. Change the Forward setting to "Accept".


  6. Click Save and Apply

  7. Connect your device to the router's LAN.

Before proceeding, we recommend that you confirm that devices belonging to the router's LAN can access the Soracom network using Soracom's Ping response service.


VPG Settings

You can configure a SIM-Based Routing from the User Console.

  1. Login to the User Console. From the Menu, open the VPG screen.

  2. From the list of VPGs, click the name of the VPG you want to configure to open its settings page.

  3. Click the Device LAN tab.

  4. From the SIM-Based Routing panel, click the Add button to add an IP Range entry.

    Add IP SIM-Based Routing entry

  5. Enter the IP Range of your router's LAN in CIDR notation and the SIM ID of the SIM in that router. Multiple IP range and SIM ID associations can be defined at once.

    By default, you will only be able to associate IP ranges with SIM IDs that are currently registered to your account. If you would like to add entries for SIM cards that are not yet registered to your account, please check the Allow registration of non-owned SIMs box.

    If a Subscription Container has been added to the SIM, the secondary subscriptions on the SIM ID will also be displayed as suggestions. SIM-based routing differentiates SIMs by SIM ID, so slecting a secondary subscription will work identically to choosing the primary subscription.

    Add entry

    Please be aware of the following information when setting associations:

    • The same IP range cannot be assigned to multiple SIMs.
    • If the IP ranges of multiple entries overlap, packets will be routed to the more precisely matched IP range that has the longest subnet mask. For example: if SIM A is associated with IP range and SIM B is associated with IP range, traffic for will be routed to SIM B.
    • Soracom Arc virtual SIMs cannot be mapped to IP ranges.
  6. After you have completed your click Save Config Settings.

  7. Click the Enable SIM-Based Routing toggle to enable the feature.

    Enable SIM-Based Routing

When enabling and disabling SIM-Based routing, there will be a temporary interruption in all communications for the VPG. The new SIM-Based Routing configurations will be available to use once the respective SIMs re-establish their sessions.


When using SIM-Based Routing, the following limitations apply:

Programmatic Usage

You can use the Soracom API and Soracom CLI to configure SIM-Based Routing entries programmatically.

For example, the following body assigns the IP range to SIM_ID_1, and to SIM_ID_2.

  "SIM_ID_1": "",
  "SIM_ID_2": ""

Then, simply pass in the SIM-Based Routing entries to the Soracom API or Soracom CLI. For either method, you will need to specify the VPG ID.

Soracom API

To access the Soracom API, first use the auth API to obtain an API Key and Token. Refer to the API Reference Guide for instructions on how to use the API Key and Token in API requests.

Then, use the putSimBasedRoutingRoutes API to add or update the SIM-Based Routing entry:

curl -X POST \
>  -H 'X-Soracom-API-Key: <MY-API-KEY>' \
>  -H 'X-Soracom-Token: <MY-TOKEN>' \
>  -H 'Content-Type: application/json' \
>  -d '{
>        "SIM_ID_1": "",
>        "SIM_ID_2": ""
>      }' \

To enable or disable SIM-Based Routing, use one of the following APIs:

Soracom CLI

To use the Soracom CLI, you must first configure it to authenticate with your account information, authorization key, or SAM user credentials.

Then, run the following command to add or update the IP address mapping entry:

soracom vpg put-sim-based-routing-routes --vpg-id '<VPG-ID>' --body '@path/to/sim-based-routing-entries.json' --coverage-type g

In this sample, we're using the @filename method for passing in the SIM-Based Routing entries which are stored in a separate file, but you can of course pass the raw data into the --body parameter directly.

To enable or disable SIM-Based Routing, use one of the following CLI commands:

  • soracom vpg enable-sim-based-routing --vpg-id '<VPG-ID>'
  • soracom vpg disable-sim-based-routing --vpg-id '<VPG-ID>'