Welcome aboard! In the following guide you will learn how to configure your first service on netjump!

We are going to expose a HTTP server running at port 80 on a local device. In summary, we are going to:

• Create a new device in the netjump cloud server, so the client agent will be able to connect to the cloud and expose the configured services
• Install the client agent in the local device
• Setup the agent's initial configuration file, with your Auth Token and the device id
• Run the client agent
• Done! The HTTP server will be exposed by a fixed URL, as HTTPS (secure)

Netjump Cloud Config

1. Add a device

• Go to My Devices page and click on
  + Add Device
• Enter a device name and click on
  Add
  
  

2. Add a service to the device

In this example, we are going to expose the HTTP server running at the port 80 of the device

• In the next screen, enter a name for the service, set the protocol to HTTP and port to 80. Then, click on
  Add Service
  
  

Client Agent Config

1. Install the client app on your device

# Download the client app
wget https://pb.netjump.dev/downloads/releases/1.1.3/netjump_linux_amd64.zip

# Unzip
unzip netjump_linux_amd64.zip

# Test the client
./netjump --version

2. Configure the client

You will need your Auth Token and the device-id of the device you just configured in the cloud

• To get the auth token, go to My Devices page, click the Show button and copy the token



Your auth token will have a similar format to this one. This is just a example auth token and it is invalid.

• To get the device-id, go to My Devices page, click on your device and copy its device-id


• Now run ./netjump init YOUR-AUTH-TOKEN your-device-id to create the initial config file

3. Run the Client Agent

./netjump

Done! Now you should be able to access your service from the dashboard.

Go to My Devices, click on your device, click on the service your want to access (Web Page in the example)