---
title: "Publish to App Market for testing"
description: "Import your app template into an ARX system, install the app from App Market, and ship a new version — the path differs between ARX v1.0 and v1.1"
canonical_url: "https://developer.ardge.com/en/guide/isv/publish-to-app-market"
---
# Publish to App Market for testing

> Import your app template into an ARX system, install the app from App Market, and ship a new version — the path differs between ARX v1.0 and v1.1

## Overview

Apps on an ARX system are installed through App Market. During development, you can import your own app template into the system so that your app shows up in App Market and you can run integration tests on real hardware.

How you import the template differs by ARX OS version: **ARX v1.0** uses a Zot Registry hosted inside the system, while **ARX v1.1** uses a GitHub repository.

## What you'll learn

- Import the template into an ARX system (pick the path for your version)
- Install your app from App Market
- Ship a new version to an installed system

## Applies to

- ARX OS 1.0 and later

## Before you begin

- Your app template is ready — see [Prepare your app template](https://developer.ardge.com/en/guide/isv/prepare-app-template)
- Your container image can be pulled from an address the ARX system can reach

## Step 1. Import the template into the ARX system

Follow the section that matches your system.

### ARX v1.0: through a Zot Registry

<warning>

**This path needs the system owner account:** the account and password you use for SSH are the ARX system's owner account and password.

</warning>

1. Create an ARDGE account, then apply to ARDGE for developer access on it
2. Open **Control Panel** in the ARX admin interface and sign in with that ARDGE account
3. Open the **Terminal** page in the **Control Panel** app and turn on SSH

Everything after this runs from your development machine. Replace these placeholders with your own values as you go:

<table>
<thead>
  <tr>
    <th>
      Placeholder
    </th>
    
    <th>
      What to enter
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        {arx-ip}
      </code>
    </td>
    
    <td>
      The IP address of the ARX system, for example <code>
        192.168.5.63
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        {ssh-user}
      </code>
    </td>
    
    <td>
      The ARX system's owner account, which is also the SSH account
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        {ssh-password}
      </code>
    </td>
    
    <td>
      That account's password — you are prompted for it the first time you connect
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        {your-email}
      </code>
    </td>
    
    <td>
      The email address to label your SSH key with
    </td>
  </tr>
</tbody>
</table>

#### Set up SSH access

Create a key pair and copy the public key to the ARX system, so the later steps connect without a password prompt:

```bash
# Create the key pair
ssh-keygen -t ed25519 -C "{your-email}"

# Copy the public key to the ARX system — enter {ssh-password} when prompted
ssh-copy-id -i ~/.ssh/id_ed25519.pub {ssh-user}@{arx-ip}
```

#### Run the skills with your AI agent

<note>

**Download the skills:** the bundle is [arx-isv-skills-v0.6.4.zip](https://developer.ardge.com/skills/arx-isv-skills-v0.6.4.zip) (about 185 KB) — unzip it and copy the folders inside into your project's `.claude/skills/`.

</note>

1. Unzip the skills bundle into `arx-isv-guide/`
2. Start the agent in that directory:```bash
cd arx-isv-guide
claude
```
3. Ask agent to check the connection: `verify the connection to {ssh-user}@{arx-ip}`
4. Ask agent to deploy the sample app: `deploy hello app to this arx`
5. Grant passwordless sudo so the agent can finish without stopping for a password:```bash
ssh -t {ssh-user}@{arx-ip} 'sudo sh -c "echo \"{ssh-user} ALL=(ALL) NOPASSWD:ALL\" > /etc/sudoers.d/90-{ssh-user}-nopasswd && chmod 440 /etc/sudoers.d/90-{ssh-user}-nopasswd"'
```

<warning>

**Passwordless sudo is for a development system:** it removes the password prompt for every `sudo` command on that account. Use it on a system you are developing against, not on a customer's.

</warning>

1. Ask agent to apply: `run apply`. Once it reports that the run finished, open **App Market** in the ARX web interface and click refresh — your application is in the list

That run creates the registry, injects the ARX CA into the three components, writes the node's `certs.d`, and switches the marketplace URI over. It then imports your image into the node's containerd, pushes it to Zot, confirms the chart is in the registry, and seeds the marketplace with the official entries plus your app's overlay.

### ARX v1.1: through a GitHub repository

1. Put the template you wrote into a GitHub repository
2. If the repository is private, request a GitHub repository token first
3. Sign in to the ARX admin interface and open **Control Panel › Internet Account**
4. Click **Add Repository** and fill in the fields as follows
5. Click save

<table>
<thead>
  <tr>
    <th>
      Field
    </th>
    
    <th>
      What to enter
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      GitHub link
    </td>
    
    <td>
      The full address, including the org name and the repo name
    </td>
  </tr>
  
  <tr>
    <td>
      GitHub repository token
    </td>
    
    <td>
      Only required when the repository is private
    </td>
  </tr>
</tbody>
</table>

## Step 2. Install your app from App Market

1. Open **App Market**
2. Click the refresh button in the top-right corner
3. Find your app and click install
4. Wait for the installation to finish

Installation is complete at this point, and you can start testing your application.

## Update your app version

Bump the version number in your template, and App Market shows an available update for that app. This is the fastest way to ship a new version of your app on the platform.

## Next step

<card-group>
<card icon="i-lucide-handshake" title="Ship through the official channel" to="https://developer.ardge.com/en/guide/isv/shipping-channel">

Move from a test install to shipping your application to customers as an ARDGE partner

</card>
</card-group>


## Sitemap

See the full [sitemap](https://developer.ardge.com/sitemap.md) for all pages.
