Skip to main content

Linux

Atym runs on Linux-based systems as a lightweight process that can run in the background and connects your device to the Atym Hub — no flashing or board-specific setup required.

Atym currently provides Linux builds for x86_64 and aarch64 architectures, supporting devices from Intel/AMD-based systems to development boards like the Raspberry Pi 4/5.

Prerequisites​

Before setting up your device with Atym, ensure you have the following:

Hardware​

  • A Linux target device (x86_64 or aarch64)
  • An active internet connection

Software​

  • Atym CLI installed on your development machine (you'll use it to register the device)

Prepare Your Device​

Simply connect your Linux target device to an active internet connection. No additional board-level setup is required.

Add Device to the Atym Hub​

First, create a digital identity for your Linux device in the Atym Hub using the Atym CLI on your development computer. Later in this guide, you’ll apply those credentials directly on the Linux device itself to register it with the Atym Hub.

  1. Run the following command, replacing the values with your own (see the add device CLI reference for all available options):
atym add device --deviceName "testDevice" --description "My test device" --serialNumber "1234567890"

If successful, you’ll receive a response containing your deviceUUID and pskSecret. For example:

{
  "deviceUUID": "67c1c350-cc1c-482d-bde9-875688ff9b23",
  "pskSecret": "IEAaeWHKhYs4fAScF5ApQ0C9eGcXu123",
  "tenantUUID": "2C9D9E73-702E-49DF-8181-F7B56849B864"
}

Copy both values to a secure location. You’ll need them when configuring your Linux device.

  1. Retrieve your tenant ID by running:
atym show config

From the output, copy the Tenant ID value — you’ll use it together with your deviceUUID and pskSecret in the next steps.

Download and Install Atym​

The Atym Linux runtime is distributed as a tar.gz archive containing a statically linked binary. Archives are available for x86_64 and aarch64 architectures.

  1. On your Linux device, download the correct archive for your architecture:
wget https://atympublicshare.blob.core.windows.net/runtime/linux/latest/atym-runtime-ubuntu-x86_64.tar.gz
Alternative

You can also download the archive on your development machine and transfer it to your Linux device using scp.

  1. Extract the archive:
tar -xzf atym-runtime-ubuntu-x86_64.tar.gz

This will create an atym-runtime directory containing:

  • bin/atym-runtime - The Atym runtime binary
  • sbom - Software Bill of Materials files (SPDX format)

Register Device with the Atym Hub​

Now configure your Linux device with the credentials generated earlier.

Device Console Required

The following steps must be performed on your Linux target device, NOT your development machine.

  1. Navigate to the extracted runtime directory:
cd atym-runtime
  1. Set the device identity using your deviceUUID and tenantID:
atym config set device/id deviceUUID@tenantID
  1. Configure the device's pre-shared key:
atym config set device/psk pskSecret
  1. Set the Atym Hub connection details:
atym config set server/endpoint coapgw.prod.atym.io
atym config set server/port 5684
  1. Verify your configuration:
atym config show

Example output:

Current configuration:
  device/id: a612baee-dd15-42cc-a0dc-a0783c186bb5@a60dbceb-270e-4b14-a93c-60809b34c123
  device/psk: ct6P/zFOHQbvrLyRFrnh22XnXQ1H8+at
  server/endpoint: coapgw.prod.atym.io
  server/port: 5684
  1. Start the Atym runtime:
./bin/atym-runtime

If your device successfully connects to the Atym Hub, you'll see the following message in the terminal output:

Client connected successfully

Next Steps​

Congratulations! Your Linux device is now configured and securely connected to the Atym Hub. You can begin deploying and running containerized applications just like on a development board.

Continue with the Build and Deploy Containers guide to create, build, and deploy your first containerized application.