Skip to content

steccas/xbs-api-docker

 
 

Repository files navigation

Buy Me A Coffee

xBrowserSync API for Docker customized

Hi, this is custom version of the official xBrowserSync Docker. I made it to simplify my personal deployment and fit my personal needs.

Changes made

  • healthcheck.js and settings.json are going to be copied inside the container by the dockerfile; so it will not longer be necessary to be mounted as volumes in docker-compose.yml unless needed.
  • dockerfile will build from latest alpine
  • dockerfile will get latest version of xBrowserSync API, CI/CD Will keep the image build fresh, so the API in use will always be updated if you use systems like watchtower.
  • docker-compose.yml will fetch latest version of the image.
  • Removed caddy, so you can integrate the containers with an existing proxy like Traefik or Jwilder's proxy.
  • ARM Support

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create.

And this project can be greatly improved!

Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

You can also consider to help with a donation and checking my links ❤️
check! GitHub Sponsor Buy Me A Coffee

Running a production-ready service

  1. Clone the this repo:

    git clone https://github.com/Steccas/api-docker.git
    
  2. Open the .env file in a text editor and update the API_HOSTNAME value to correspond to the host name that the API service will be exposed over (ensure you have configured your DNS provider to point the desired host name to your host's IP address). Also, change the DB_USERNAME and DB_PASSWORD values to any of your choosing.

  3. (Optionally) open the settings.json file and include any custom settings values you wish to run on your service. Important: do not change the db.host value. And remember in this case to uncomment the volume mounting in docker-compose.yml.

  4. Run the following command to start the containers:

    docker-compose up -d
    

    You can now access your xBrowserSync API service at the value of API_HOSTNAME defined in the .env file.

Issues and feature requests

Please cosnider that this is just a fork, so if the problem doesn't exists just in this implementation please log Docker-related issues directly in the api-docker Issues list, if you have found an issue with the xBrowserSync API itself or wish to request a new feature, do so in the api Issues list.