{"id":21385374,"url":"https://github.com/touchifyapp/docker-browser-sync","last_synced_at":"2026-02-26T01:11:49.173Z","repository":{"id":98958732,"uuid":"155793593","full_name":"touchifyapp/docker-browser-sync","owner":"touchifyapp","description":"Browsersync Docker Image: Keep multiple browsers \u0026 devices in sync when building websites.","archived":false,"fork":false,"pushed_at":"2018-11-02T01:10:04.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-04T18:56:00.518Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/touchifyapp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-11-02T00:44:18.000Z","updated_at":"2018-11-02T01:02:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"39f1cce6-edda-4fad-a04a-2f5a70ab31b4","html_url":"https://github.com/touchifyapp/docker-browser-sync","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/touchifyapp/docker-browser-sync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchifyapp%2Fdocker-browser-sync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchifyapp%2Fdocker-browser-sync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchifyapp%2Fdocker-browser-sync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchifyapp%2Fdocker-browser-sync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/touchifyapp","download_url":"https://codeload.github.com/touchifyapp/docker-browser-sync/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchifyapp%2Fdocker-browser-sync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29847074,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T22:37:40.667Z","status":"ssl_error","status_checked_at":"2026-02-25T22:37:25.960Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-22T11:47:12.292Z","updated_at":"2026-02-26T01:11:49.168Z","avatar_url":"https://github.com/touchifyapp.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Supported tags and respective Dockerfile links\n\n*  [`2.26.3`, `2.26`, `2`, `latest` (Dockerfile)](https://github.com/touchifyapp/docker-browser-sync/blob/master/Dockerfile)\n\nThis image is updated via [pull requests to the `touchifyapp/docker-browser-sync` GitHub repo](https://github.com/touchifyapp/docker-browser-sync/pulls).\n\n# [Browsersync](http://http://browsersync.io): Keep multiple browsers \u0026 devices in sync when building websites.\n\n![Browsersync logo](https://raw.githubusercontent.com/BrowserSync/browsersync.github.io/master/public/img/logo-gh.png)\n\n`Browsersync` keeps multiple browsers \u0026 devices in sync when building websites.\n\n## How to use\n\nThe basic Browser Sync examples translated are the exact same commands with the docker command prefixing it.\n\n### Static websites\n\nThe following case publishes port 3000 and port 3001 so you can use the static server and configure Browser Sync as always.\n\n```\n$ docker run -dt \\\n$   --name browser-sync \\\n$   -p 3000:3000 \\\n$   -p 3001:3001 \\\n$   -v $(PWD):/source \\\n$   touchifyapp/browser-sync \\\n$   start --server --files \"css/*.css\"\n```\n\n### Dynamic websites\n\nIn this case, you have to let Docker know how to resolve the host you are proxying to. There are a couple of ways to do this so we'll go one by one.\n\n#### Link\n\nA docker link is a one-way connection between two containers. Order matters so you have to first start your app and then link Browser Sync to it:\n\n```\n# Run your app\n$ docker run -dt --name myapp -p 8000:8000 myimage\n\n# Run Browsersync as a proxy\n$ docker run -dt \\\n$   --name browser-sync \\\n$   --link myapp \\\n$   -p 3000:3000 \\\n$   -p 3001:3001 \\\n$   touchifyapp/browser-sync \\\n$   start --proxy \"myapp:8000\" --files \"css/*.css\"\n```\n\n#### Custom network\n\nA docker network is a connection between multiple containers. Unlike links, order does not matter so it is a more robust solution, but it requires setting up the network before running the containers.\n\n```\n# Create the network (one-time)\n$ docker network create mynetwork\n\n# Run your app\n$ docker run -dt --name myapp --net mynetwork myimage\n\n# Run Browsersync as a proxy\n$ docker run -dt \\\n$   --name browser-sync \\\n$   --net mynetwork \\\n$   -p 3000:3000 \\\n$   -p 3001:3001 \\\n$   touchifyapp/browser-sync \\\n$   start --proxy \"myapp:8000\" --files \"css/*.css\"\n```\n\n### Config file\n\nSince the image exposes Browser Sync's CLI as is, you can use a config file as well.\n\n```\n$ docker run -dt \\\n$   --name browser-sync \\\n$   -p 3000:3000 \\\n$   -p 3001:3001 \\\n$   -v $(PWD)/bs-config.js:/source/bs-config.js \\\n$   touchifyapp/browser-sync \\\n$   start --config bs-config.js\n```\n\n## Command line options\n\n```\n-server, -s             Run a Local server (uses your cwd as the web root)\n--cwd                   Working directory\n--json                  If true, certain logs will output as json only\n--serveStatic, --ss     Directories to serve static files from\n--port                  Specify a port to use\n--proxy, -p             Proxy an existing server\n--ws                    Proxy mode only - enable websocket proxying\n--browser, -b           Choose which browser should be auto-opened\n--watch, -w             Watch files\n--ignore                Ignore patterns for file watchers\n--files, -f             File paths to watch\n--index\tSpecify         which file should be used as the index page\n--plugins               Load Browsersync plugins\n--extensions            Specify file extension fallbacks\n--startPath             Specify the start path for the opened browser\n--single                If true, the connect-history-api-fallback middleware will be added\n--https                 Enable SSL for local development\n--directory             Show a directory listing for the server\n--xip                   Use xip.io domain routing\n--tunnel                Use a public URL\n--open                  Choose which URL is auto-opened (local, external or tunnel), or provide a url\n--cors                  Add Access Control headers to every request\n--config, -c            Specify a path to a configuration file\n--host                  Specify a hostname to use\n--logLevel              Set the logger output level (silent, info or debug)\n--reload-delay          Time in milliseconds to delay the reload event following file changes\n--reload-debounce       Restrict the frequency in which browser:reload events can be emitted to connected clients\n--ui-port               Specify a port for the UI to use\n--watchEvents           Specify which file events to respond to\n--no-notify             Disable the notify element in browsers\n--no-open               Don't open a new browser window\n--no-online             Force offline usage\n--no-ui                 Don't start the user interface\n--no-ghost-mode         Disable Ghost Mode\n--no-inject-changes     Reload on every file change\n--no-reload-on-restart  Don't auto-reload all browsers following a restart\n```\n\n## License\n\nView [license information](https://github.com/touchifyapp/docker-browser-sync/blob/master/LICENSE) for the software contained in this image.\n\n## Supported Docker versions\n\nThis image is officially supported on Docker version 1.12+.\n\nPlease see [the Docker installation documentation](https://docs.docker.com/installation/) for details on how to upgrade your Docker daemon.\n\n## User Feedback\n\n### Documentation\n\nDocumentation for this image is stored in [the `touchifyapp/docker-browser-sync` GitHub repo](https://github.com/touchifyapp/docker-browser-sync).\nBe sure to familiarize yourself with the repository's README.md file before attempting a pull request.\n\n### Issues\n\nIf you have any problems with or questions about this image, please contact us through a [GitHub issue](https://github.com/touchifyapp/docker-browser-sync/issues).\n\n### Contributing\n\nYou are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.\n\nBefore you start to code, we recommend discussing your plans through a [GitHub issue](https://github.com/touchifyapp/docker-browser-sync/issues), especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftouchifyapp%2Fdocker-browser-sync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftouchifyapp%2Fdocker-browser-sync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftouchifyapp%2Fdocker-browser-sync/lists"}