avalon-docker

The project contains the Dockerfiles for all the necessary components of Avalon Media System. For developing with Avalon, the docker-compose script in Avalon and Avalon Bundle are recommended.

Prerequisite

Linux

1. Install Docker
2. Install Docker-Compose

OSX

• Install Docker Desktop for Mac

Usage

1. Clone this Repo
2. Copy dotenv.example to .env and fill in the passwords and Rails secret key base.
3. From inside the avalon-docker directory
   • sudo chmod a+w masterfiles solr_data to setup write permissions for shared directories
   • docker-compose pull to get the prebuilt images from Dockerhub
   • docker-compose up to stand up the stack
4. Create a user account by visiting http://localhost/users/sign_up in your browser.
5. Make the user an admin by running docker-compose exec avalon bundle exec rake avalon:user:admin

Notes

• docker-compose logs <service_name> to see the container(s) logs
• docker-compose build --no-cache <service_name> to build the image(s) from scratch
• docker ps to see all running containers
• docker exec -it avalondocker_avalon_1 /bin/bash to log into Avalon docker container

Troubleshooting

• If the avalon and fedora containers do not come up the first time you run docker-compose up try restarting everything:

  docker-compose down
  docker-compose up

• If you have problems with solr or fedora not starting then add the following to their declarations in docker-compose.yml:

    ulimits:
      nofile:
        soft: 65536
        hard: 65536

Advanced Usage

Running on a server

Set these Avalon env vars:

• SETTINGS__DOMAIN=http://<ip address or hostname>/
• STREAMING_HOST=<ip address or hostname> so Avalon crafts the right streaming URLs