ION

ION is a distributed RTC system written by pure go and flutter

Wiki

https://github.com/pion/ion/wiki

Architecture

Contributing

• adwpc - Original Author - ion server
• cloudwebrtc - Original Author - ion server and client sdk
• kangshaojun - Contributor UI - flutter and react.js
• Sean-Der - ion server and docker file
• sashaaro - docker file
• tarrencev - audio video process

Roadmap

Projects Welcome contributing to ion!

Stars

Screenshots

iOS/Android

PC/HTML5

How to use

Local Deployment

1. Clone

git clone https://github.com/pion/ion

2. Run

Firstly pull images. Skip this command if you want build images locally

docker-compose pull

docker-compose up

3. Chat!

Open this url with chrome

http://localhost:8080

Online Deployment

1. Clone

git clone https://github.com/pion/ion

2. Set Env

export WWW_URL=yourdomain
export ADMIN_EMAIL=yourname@yourdomain

3. Configure docker compose

Enable production ports and Caddy file for web service in docker-compose.yml.

4. Expose Ports

Ensure the following ports are exposed or forwarded.

80/tcp
443/tcp
5000-5200/udp

5. Run

docker-compose up

6. Chat!

Open this url with chrome

https://yourdomain

Docker Tips

The provided docker-compose works for deploying to open usage, and can also be used for local development. It also supports auto-generate of certificates via LetsEncrypt.

It accepts the following enviroment variables.

• WWW_URL -- Public URL if auto-generating certificates
• ADMIN_EMAIL -- Email if auto-generating certificates

To run on conference.pion.ly you would run WWW_URL=conference.pion.ly ADMIN_EMAIL=admin@pion.ly docker-compose up

If WWW_URL is set you will access via https://yourip:8080 OR http://yourip:8080 if not running with TLS enabled.