marcsbrooks/docker-opensimulator-server repository overview

⁠Starting the container

Once you have successfully pulled the repository run:

$ docker run -d -p 9000:9000/tcp -p 9000:9010/udp --env EXTERNAL_IP=<ip-address> marcsbrooks/docker-opensimulator-server:latest

⁠Accessing the container

$ docker exec -it <container-id> /bin/bash

⁠Managing the grid server

The following command can be executed within the Docker container:

$ service grid-server {start|stop|restart}

⁠Overriding grid server sources

In cases where you have an existing server set-up (e.g. configuration) follow the steps below:

⁠Copy the files to the container

$ docker cp OpenSim.ini <container-id>:/usr/games/OpenSim.ini
$ docker cp Region.ini <container-id>:/usr/games/Regions/Region.ini
..

⁠Restart the grid server

$ docker -it <container-id> /usr/sbin/service grid-server restart

⁠Importing a custom database

If you have an existing database (MySQL backup *.sql) that you want to use, thereby overriding the installation default, you will need to manually run the server launch operations using the following workflow:

$ docker run -d -p 9000:9000/tcp -p 9000:9010/udp --env EXTERNAL_IP=<ip-address> marcsbrooks/docker-opensimulator-server:latest sleep infinity
$ docker cp <filename>.sql <container-id>:/tmp/opensim.sql
$ docker exec -d <container-id> /usr/games/launch.sh

Please note the configured OpenSim release version⁠ since older databases may introduce backwards compatibility issues.

⁠Additional information

• Created using docker-opensimulator⁠
• Run this image in Amazon EC2⁠
• Open Simulator (release 0.9.2.1⁠)

⁠Contributions

If you fix a bug, or have a code you want to contribute, please send a pull-request with your changes.

⁠Versioning

This package is maintained under the Semantic Versioning⁠ guidelines.

⁠License and Warranty

This package is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

docker-opensimulator is provided under the terms of the MIT license⁠

⁠Author

Marc S. Brooks⁠