Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
etc
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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
$ 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.
  • 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.

Translations

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.

Admin

See: Activating Admin

Resources

License

MIT License © Alfred Gutierrez

You can’t perform that action at this time.