ActyxOS on Windows

Beta version only for development purposes

Beta versions provide early access to future releases. They are intended for development purposes only as they may change without warning or can be removed entirely from a future release. Beta versions must not be used in production environments. ActyxOS on Windows does currently not support any runtimes for apps.

Install ActyxOS on Windows

Edge device requirements

Your edge device must meet the following requirements to install ActyxOS on Windows:

  • Windows 10
  • amd64 architecture

Required ports

ActyxOS currently requires five ports to operate. Before starting ActyxOS make sure that these ports are not already in use by another program.

  • 4001 - Used for internode communication
  • 4243 - Exposes a WebSocket endpoint for the Actyx Pond (only on localhost)
  • 4454 - Exposes the Event Service (only on localhost)
  • 4457 - Exposes the Console Service
  • 8080 - Exposes an IPFS Gateway (only on localhost)

The following ports are reserved for future use. The services exposed there are currently still in alpha testing.

  • 4455
  • 4458

Install ActyxOS on your edge device

You can download an installer for ActyxOS on Windows on the downloads page. After opening the installer, you are guided through the setup process.

ActyxOS Node Manager included

The installer also includes the latest release of the ActyxOS Node Manager.

ActyxOS is automatically started after the installation is finished.

If you have problems with installing ActyxOS, please check our Troubleshooting section below.

Check the status of your node

In order to check on its status and interact with the node, you can use the ActyxOS Node Manager or, if you prefer a command line tool, use the Actyx CLI.

Go to the Status tab, and you should that your ActyxOS node is reachable and running:


Congratulations, you have successfully installed ActyxOS on Windows! Please note that ActyxOS is not operational, as you did not configure it yet. If you want to find out more about configuring ActyxOS node, please check our guide about configuring nodes.

Where to go next

  • Quickstart is a tutorial about ActyxOS with ready-to-use apps and configurations
  • Get started for a detailed guide on how ActyxOS on Windows works
  • Troubleshooting describes common problems, workarounds and how to get help and submit issues
  • FAQs provides answers to frequently asked questions

Get started with ActyxOS on Windows

Starting and Stopping ActyxOS

ActyxOS is automatically started after the installation is finished. ActyxOS runs as a Windows Service and can therefore be managed through the Windows Services Manager. This is a guide for opening the Windows Service Manager.

In the Windows Service Manager, you will see that ActyxOS is running. You can now restart ActyxOS, stop it, and start it again:

Windows Service Manager

If you would like to know more about how to configure nodes, please go to the section Configuring nodes in our guide on Node and App Settings.

Node and App lifecycles

Depending on the lifecycle stage that your ActyxOS nodes or apps are in, your interaction with it might be limited to certain commands. Please check our guide on Node and App Lifecycles to find out more.

Automatic start of ActyxOS

When your device is started, ActyxOS is automatically started too. You can configure this by right-clicking on ActyxOS in the Services Manager and then changing the Startup type in the properties.

Windows Service Manager 2

Logging through the Windows Event Viewer

ActyxOS logs can be accessed through the Windows Event Viewer. In the Event Viewer, you can create a custom view filtering for ActyxOS logs and a log level:

Event viewer custom view

You can then see all ActyxOS logs in that view:

Event viewer


Getting help and filing issues

If you want to get help or file issues, please write an e-mail to [email protected]

Error during installation

If you receive the following error during installation, please close the Windows Event Viewer and press Retry:

Installation error

ActyxOS is not starting

The most common reason for this problem is that one of the ports ActyxOS needs is already in use by another program. ActyxOS currently uses the following ports:

  • 4001
  • 4243
  • 4454
  • 4457
  • 8080

As port 8080 is sometimes already in use by other programs, you can change it by setting the ACTYXOS_IPFS_NODE__GATEWAY_PORT environment to a different port. You can do this by following these steps:

  1. Open the Windows Control Panel
  2. Go to System and Security
  3. Go to System
  4. Go to Advanced System Settings
  5. Click on Environment Variables on the bottom right
  6. Add a new environment variable:

Windows environment variable

ActyxOS node not responding

First, check that you entered the right IP in the ax command. If you still cannot connect, the output of ax nodes ls and the returns one of the two possible reasons (if you are using the ActyxOS Node Manager, you can see this info in the Status tab):

  • ActyxOS is not reachable. This means that ActyxOS is not running on your node. Please click on the ActyxOS icon on your home screen. If ActyxOS is running, you can see it in the notifications overview of your Windows device
  • Host is not reachable. This means that your development machine cannot connect to your node. Please check that your development machine and your node are in the same network, and your firewall(s) allows them to connect via port 4457