/docker-opensimulator-standalone

Primary LanguageDockerfile

docker-opensimulator-standalone

Docker container for OpenSimulator 0.9.1

"OpenSimulator is an open source multi-platform, multi-user 3D application server. It can be used to create a virtual environment (or world) which can be accessed through a variety of clients, on multiple protocols. It also has an optional facility (the Hypergrid) to allow users to visit other OpenSimulator installations across the web from their 'home' OpenSimulator installation. In this way, it is the basis of a nascent distributed Metaverse."

Install dependencies

To install docker in Ubuntu 18.04 use the commands:

$ sudo apt-get update
$ sudo wget -qO- https://get.docker.com/ | sh

To install docker in other operating systems check docker online documentation

Usage

This container image is set up for running up one standalone region on port 9000. If you already have a Regions.ini file, map it into the container as /opt/opensim/bin/Regions/Regions.ini using -v If you don't, run the "first configuration" step described in the next section.

If you want your region data to persist across container recreations or updates, mount a volume or a folder into /home/opensim/opensim/bin/persistence

To run container use the command below, adapt the port range to match the number of regions you want to run:

$ docker run -ti -d \
             -p 9000-9008:9000-9008 -p 9000-9008:9000-9008/udp \
             { -v your.region.ini:/home/opensim/opensim/bin/Regions/Regions.ini} \
	 { -v opensim_data:/home/opensim/opensim/bin/persistence } \
             lemmy04/opensim-standalone:latest

For the first configuration :

Enter the running container:

 $ docker exec -it container_id /bin/bash -login

Then, attach to the running opensim process with this:

 $ screen -r

Then respond to the questions related to your virtual word:

  • New region name []: ==> need to entry region name that you want for it .(need to remember it).

  • RegionUUID [29923331-dddd-4acc-a3d8-46d3c129b6e3]: ==> press enter key to keep the same.

  • Region Location [1000,1000]: ==> press enter key to keep the same.

  • Internal IP address [0.0.0.0]: ==> press enter key to keep the same.

  • Internal port [9000]: ==> press enter key to keep the same.

  • Resolve hostname to IP on start (for running inside docker) [False]: ==> press enter key to keep the same.

  • External host name [SYSTEMIP]: ==> need to entry the external ip or your http address don't include the port.

  • New estate name [My Estate]: ==> press enter or change it.

  • Estate owner first name [Test]: ==> change or enter for default Test (need to remember it).

  • Estate owner last name [User]: ==> change or enter for default User (need to remember it).

  • Password: ==> remember it for login (need to remember it).

  • Email: ==> .....

  • User ID [6edd775a-8c1e-4a43-ad16-36df2af3ea0c]: ==> press enter key to keep the same.

After some process it will show:

Region (.....) #

  • 'quit' command to continue.

You will now have to restart the container, and possibly change the restart policy.

Use viewer to check the virtual world create by OpenSimulator:

Imprudence viewer http://wiki.kokuaviewer.org/wiki/Imprudence:Downloads

Grid Manager to add your virtual world to the application ...

Where:

Everything else no important at this moment. Press apply and then use info to log in.

More Info

About OpenSimulator www.opensimulator.org

To help improve this container lemmy04/docker-opensimulator-standalone