AnxOSSetup Guide

First server, step by step

From download to game night

Set up AnxOS, create your first server, and share it with friends using guided controls—no terminal knowledge needed.

Download AnxOSCreate an account

Get the app

Download AnxOS

Open the official download page and choose the package for this computer.

Windows installer

Recommended for most Windows users. It installs AnxOS and adds normal shortcuts.

Windows portable

Runs without a full installation. Keep the executable in a folder you can find again.

Linux AppImage

A portable Linux build. Download it, allow it to run, then open it.

Linux .deb

Recommended for Debian and Ubuntu-based distributions.

View all downloads

On this computer

Install and launch

Windows

  1. Open the downloaded installer.
  2. Confirm the verified publisher and follow the setup screens.
  3. Approve administrator access if Windows asks; it is only needed for protected install or service changes.
  4. Launch AnxOS Control Center.

Linux AppImage

  1. In your file manager, open the file’s Properties.
  2. Under Permissions, enable Allow executing file as program.
  3. Double-click the AppImage to launch it.
Command fallback
chmod +x AnxOS-Control-Center-*.AppImage

Linux .deb

  1. Open the package in your software installer.
  2. Select Install and enter your administrator password when requested.
  3. Launch AnxOS from your applications menu.
Command fallback
sudo apt install ./AnxOS-Control-Center-*.deb

Your account

Sign in and create the Local Owner

  1. Sign in with your AnxOS account, or choose Create account.
  2. Complete the first-run Local Owner setup.
  3. Store the Local Owner credentials somewhere secure and separate from the server.

Connect the worker

Connect the Local Agent

The Local Agent runs server work on this computer. A remote Agent runs on another PC, VPS, NAS, or server that you choose to manage.

  1. Open Agent Control.
  2. Choose the Local Agent and select Install or Start. Approve administrator access only if the service installation requires it.
  3. If pairing is requested, generate or enter the temporary pairing code shown by Agent setup. The permanent credential is created automatically.
  4. When the Agent says Waiting for Control Center, return to AnxOS and confirm the pending connection.
Offline

The Agent is stopped or unreachable. Start it and check that this node is selected.

Unauthorized

The saved pairing is not accepted. Pair again from Agent Control; do not paste permanent tokens.

Login Required

Sign in to AnxOS, then retry the protected action.

Check prerequisites

Prepare the node

  1. Open Prepare Node or Dependencies.
  2. Run a scan for Java, Docker, SteamCMD, .NET, Playit, Tailscale, and the other supported dependencies.
  3. Use the graphical Install or Repair action for anything your chosen server needs.
  4. Scan again and confirm required items pass.

Your first instance

Create the first server

  1. Open Marketplace.
  2. Choose a template or provider—for example, a Minecraft server or a CurseForge modpack.
  3. Select the node, memory limit, server port, and install location.
  4. Review the summary, then start the installation.

Operate safely

Start and manage the server

  1. Open Instances and select the new server.
  2. Review its configuration, then choose Start.
  3. Watch Logs and Console until the server reports that it is ready.
  4. Use the AnxOS Stop or Restart controls so the server can shut down safely.
  5. Use Files, Backups, and the configuration pages for routine management.

Optional sharing

Let friends join

Open Public Access, select the server’s node and service, then choose an access method.

Playit

The easiest public option for supported TCP or UDP game services, without router port forwarding. Install or start Playit, create the service, then copy the reported public address.

Tailscale

Private access for devices approved in your tailnet. It does not make the server public to the internet; friends must join your tailnet.

Cloudflare Tunnel

Available for supported HTTP and HTTPS services. The current workflow is not for raw UDP game-server ports, so it is generally not the Minecraft game address.

Manual networking

Only forward a port if you understand your router and firewall. Expose the single required service port, never broad ranges or management ports.

Join the game

Connect to the server

  1. Copy the server address from the instance or active Public Access service.
  2. In Minecraft, choose Multiplayer → Add Server; in another game, open its server browser or direct-connect screen.
  3. Paste the address, save it, and connect.
Localhost
localhost works only on the computer running the server.
LAN address
Use the node’s private network address for devices on the same home or office network.
Public address
Use the address shown by Playit or another configured public method for friends outside your network.

Quick fixes

Troubleshooting

Agent Offline

Open Agent Control, start the Agent, select the correct node, and retry.

Agent Unauthorized

Remove the failed pairing and pair again with a fresh temporary code.

Dependency missing

Run Prepare Node, use Install or Repair, then scan again.

Port already in use

Stop the other service or choose a different unused port in the instance configuration.

EULA not accepted

Read the Minecraft EULA; if you agree, accept it in the instance’s EULA or configuration view.

Java version mismatch

Check the template’s Java requirement, install that runtime in Dependencies, and select it for the server.

Server starts then stops

Open Logs and read the final error. Check memory, dependencies, configuration, and free disk space.

Public address unavailable

Confirm the provider is installed, connected, and supports the service protocol; then refresh Public Access.

Diagnostics and logs

Open Diagnostics to export a sanitized diagnostics bundle. Use the instance Logs and Console pages for server output.

You’re ready

Build your first server

Keep this guide open beside AnxOS and work through one step at a time.

Open the app and start setup