retro-aim-server

Retro AIM Server Quickstart for Windows 10/11

This guide explains how to download, configure and run Retro AIM Server on Windows 10/11.

  1. Download Retro AIM Server

    Download the latest Windows release from the Releases page and extract the .zip archive, which contains the application and a configuration file settings.env.

  2. Configure Server Address

    Open settings.env (right-click, edit in notepad) and set the default listener in OSCAR_ADVERTISED_LISTENERS_PLAIN to a hostname and port that the AIM clients can connect to. If you are running the AIM client and server on the same machine, you don’t need to change the default value.

    The format is [NAME]://[HOSTNAME]:[PORT] where:

    • LOCAL is the listener name (can be any name you choose, as long as it matches the OSCAR_LISTENERS config)
    • 127.0.0.1 is the hostname clients connect to
    • 5190 is the port number clients connect to

    In order to connect AIM clients on your LAN (including VMs with bridged networking), you can find the appropriate IP address by running ipconfig from the Command Prompt and use that IP instead of 127.0.0.1.

  3. Start the Application

    Launch retro-aim-server.exe to start Retro AIM Server.

    Because Retro AIM Server has not built up enough reputation with Microsoft, Windows will flag the application as a security risk the first time you run it. You’ll be presented with a Microsoft Defender SmartScreen warning prompt that gives you the option to run the blocked application.

    To proceed, click More Options, then Run anyway.

    screenshot of microsoft defender smartscreen prompt screenshot of microsoft defender smartscreen prompt

    Click Allow if you get a Windows Defender Firewall alert.

    screenshot of microsoft defender firewall alert

    Retro AIM Server will open in a terminal, ready to accept AIM client connections.

  4. Test

    To do a quick sanity check, start an AIM client, sign in to the server, and send yourself an instant message. Configure the AIM client to connect to the host and port from OSCAR_ADVERTISED_LISTENERS_PLAIN in settings.env. If using the default server setting, set host to 127.0.0.1 and port 5190.

    See the Client Configuration Guide for more detail on setting up the AIM client.

    By default, you can enter any screen name and password at the AIM sign-in screen to auto-create an account.

    Account auto-creation is meant to be a convenience feature for local development. In a production deployment, you should set DISABLE_AUTH=false in settings.env to enforce account authentication. User accounts can be created via the Management API.

  5. Additional Setup

    For optional configuration steps that enhance your Retro AIM Server experience, refer to the Additional Setup Guide.

This site is open source. Improve this page.