Project Overview

Uberserver is a lobbyserver written in python for spring lobby clients. It is currently used as the main lobby server running at lobby.springrts.com port 8200.

Prerequisites

This project is built using Python 3. Make sure you have the following installed before proceeding:

Python 3
SQLAlchemy
GeoIP
Twisted

System Packages Required

For Debian/Ubuntu:

libssl-1.0-dev
libgeoip-dev
libmariadbclient-dev or libmysqlclient-dev

# apt update
# apt install libssl1.0-dev libgeoip-dev libmariadbclient-dev

Installation Steps

Option 1: Manual Installation

Clone the uberserver source code:

git clone git@github.com:spring/uberserver.git

Create a Python virtual environment:

virtualenv ~/virtenvs/uberserver
source ~/virtenvs/uberserver/bin/activate

Install Python dependencies:
```
pip install -r requirements.txt
```
SQLite is used by default. For production, consider setting up MySQL or PostgreSQL.

Option 2: Using Docker for Local Server

Build and run the local server:

cd docker
docker-compose build
docker-compose up

To find the container ID:
```
docker ps
```

Access the database and add users:

docker exec -it your_container_id bash
sqlite3 local_server.db

Use the following command to log in:
```
docker logs your_container_id
```

The address will look like "private: 192.168.100.17:8200". Use it to log in with user1/123.

Usage

Activate the virtual environment and start the server:

source ~/virtenvs/uberserver/bin/activate
./server.py

Logs

Log file: $PWD/server.log

External Documents

Refer to https://springrts.com/wiki/Uberserver for more details.

Help and Support

For any issues or questions, refer to the server logs or Docker logs. You can also raise issues on the GitHub Repository.

Uberserver

Install / Use

README