Table of Contents

Self hosted region

Run your own OpenSim region connected to the Caprica grid. Works on a VPS or a home server with a static IP — a domain name is not required.

Or open a support ticket: https://caprica.xyz/support/


Requirements

Full checklist: REQUIREMENTS.md in the region repository.

Software (Linux):

Hardware: a 256×256 region needs ~1 vCPU, ~1 GB RAM, ~1 GB disk.

Network:


Clone the repository and run the web installer:

git clone https://github.com/capricagrid/capricaregion.git /opt/capricaregion
cd /opt/capricaregion
sudo python3 websetup.py --port 8080

It prints a one-time URL with an access key — open it in your browser. The form covers every setting (region name, UUID auto-generated, location, size, port, external IP/hostname, service protocol, SQLite/MySQL storage, firewall). After install the region starts automatically; the page shows the log and start/stop controls, and a FINISH button closes the installer when you are done.

Prefer the console? The interactive wizard does the same:

cd /opt/capricaregion && ./setup.sh

Database


First start

On the first launch OpenSim asks for an Estate name and your avatar's first and last name (registered on Caprica) in the screen console:

screen -r <region-name>    # attach once, answer the prompts
# detach: Ctrl+A then D

Wait for the message Login enabled in the console/log.


Manual configuration

The installers write these files for you; edit them by hand only if needed.

1. Region identity — bin/Regions/Regions.ini: region name, UUID (any UUIDv4 — the installers generate one), Location X,Y (pick free coordinates on the Caprica map first), SizeX/SizeY (256/512/1024), MaxPrims, InternalPort = your region port, ExternalHostName = your IP or hostname.

2. Listener port — bin/OpenSim.ini: http_listener_port must match InternalPort.

3. Service protocol — bin/OpenSim.ini constants (already set by the installers): BaseScheme = “https” for Caprica public services (:9000), PrivScheme = “http” for private services (:8003). Do not change these unless Caprica support tells you to.

4. Storage — bin/config-include/GridCommon.ini [DatabaseService] (SQLite include is active by default; uncomment the MySQL StorageProvider/ConnectionString lines for MySQL).


Firewall

Open both protocols for your region port:

sudo ufw allow 9000,8003,8002
sudo ufw allow <region_port>/tcp
sudo ufw allow <region_port>/udp

Going live

Region management: detach screen with Ctrl+A D, reattach with screen -d -r plus your region name, logs in bin/OpenSim.log and the screen console.


Troubleshooting