OpenSimulator Docker Image

A Docker image for OpenSimulator, built specifically for OpenSim AI Stack, but other use-cases as possible.

Purpose

This image will be used to start both Robust services and Simulator instances, depending on configuration.

Usage

Prepare configuration in a directory, e.g A Standalone server with a SQLite database.

 my-config
    |
    |\___ OpenSim.ini
    |\___ startup_commands.txt    # optional
    |\___ shutdown_commands.txt    # optional
    |\___ Regions
    |      \__ Region.ini
     \___ config-include
            |\__ Standalone.ini
            |\__ StandaloneCommon.ini
            |\__ FloatsamCache.ini
             \__ storage
                    \__SQLiteStandalone.ini

Run the container.

docker run --rm \
  -p 9000:9000 \
  -v examples/standalone:/config \
  -v logs:/logs \
  -v workspace:/workspace \
  bithatch/opensim-simulator:latest

Map that to /config when starting the container.

The image will start the specified OpenSimulator version after symlinking the primary configuration files to /config.

This allows the container to be pre-configured in one location.

Variables

There are a number of variables to affect behaviour.

| Name | Default | Description | | CONFIG_DIR | /config | Location of override configuration files | | LOG_DIR | /logs | Location of log files | | OPENSIM_SERVER_DLL | OpenSim.dll | Server DLL to start | | OPENSIM_GIT_REF | master | Git Branch to get for source build | | OPENSIM_RELEASE_REF | r58b7b39 | Release reference for release build | | OPENSIM_RELEASE_URL | https://github.com/opensim/opensim/releases/download/${OPENSIM_RELEASE_REF}/LastDotNetBuild.zip | Full URL of release download |