Free Mumble Hosting
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.
- Flask - Python Framework
- Flask-SQLAlchemy - PostgreSQL/SQLite ORM
- Celery - Message Queue for scheduling Mumble Server tasks
- Redis - Message broker for Celery
- Python-requests - HTTP requests to murmur-rest API
- Murmur-rest - Murmur RESTful API
For a full production deployment, please refer to INSTALL.md.
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.
$ git clone https://github.com/alfg/guildbit $ virtualenv env --system-site-packages $ . env/bin/activate $ pip install -r requirements.txt $ export FLASK_ENV=development $ export FLASK_RUN_HOST=0.0.0.0 $ export FLASK_RUN_PORT=5000 $ flask run * 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.
MURMUR_HOSTSwith 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
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
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:
Please note the
docker-compose.yml file opens ports 50001-50050 for testing. Update as needed.
Translations are welcome. To add or update a translation, please add a file or update a file in https://github.com/alfg/guildbit/tree/master/app/translations. For more information, please read the wiki.
See: Activating Admin
MIT License © Alfred Gutierrez