🔉 Free Mumble Hosting
Switch branches/tags
Nothing to show
Clone or download
Latest commit 5dbf559 Jul 20, 2018

README.md

GuildBit.com

Free Mumble Hosting

http://guildbit.com

Guildbit.com

GuildBit is a full-stack application written in Python to offer temporary virtual Mumble servers to users. Guildbit depends on murmur-rest API backend to interface with the virtual Mumble servers.

Technology Stack

Install

For a full production deployment, please refer to INSTALL.md.

Requirements

Please note murmur-rest MUST be setup in order to deploy virtual Mumble servers. However, it is possible to work on the Guildbit app without murmur-rest, you just won't be able to deploy or administer any Mumble servers.

Development Setup

$ git clone https://github.com/alfg/guildbit
$ virtualenv env --system-site-packages
$ . env/bin/activate
$ pip install -r requirements.txt
$ python manage.py runserver

* Running on http://0.0.0.0:5000/
* Restarting with reloader
  • Development server is running with default settings. See Configuration Guide for additional configuration options.
  • Update MURMUR_HOSTS with your murmur-rest host.
  • Run celery in a separate process (but in the same python environment) to start the messaging queue:
    $ celery worker --app=app.tasks -l info
    

Docker Setup

A Dockerfile and docker-compose.yml is provided for setting up a local development server.

$ docker-compose build
$ docker-compose up

redis_1 | * DB loaded from disk: 0.000 seconds
redis_1 | * The server is now ready to accept connections on port 6379
app_1   | * Running on http://0.0.0.0:5000/
app_1   | * Restarting with reloader

Load http://docker-machine-host:5000 in your browser.

When deploying a server, you'll see the Direct Link as mumble://murmur-rest:50001. Simply, replace murmur-rest with your docker-machine host. Example: 192.168.99.100.

Please note the docker-compose.yml file opens ports 50001-50050 for testing. Update as needed.

Admin

See: Activating Admin

Resources

License

MIT License © Alfred Gutierrez