{"id":30382740,"url":"https://github.com/unifykithq/chrome-codespaces-container","last_synced_at":"2025-08-20T23:13:22.704Z","repository":{"id":310489931,"uuid":"1034055557","full_name":"UnifyKitHQ/chrome-codespaces-container","owner":"UnifyKitHQ","description":"A containerized Google Chrome development environment designed specifically for GitHub Codespaces that runs in a VNC-enabled container with a web-based interface. It provides a complete Chrome browser environment that can be accessed through any web browser, making it ideal for development, testing, and remote access within GitHub Codespaces.","archived":false,"fork":false,"pushed_at":"2025-08-18T11:49:46.000Z","size":19,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-18T13:29:41.930Z","etag":null,"topics":["codespaces","containerized-applications","google-chrome","google-chrome-container","web-browser-container"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UnifyKitHQ.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}},"created_at":"2025-08-07T19:11:44.000Z","updated_at":"2025-08-18T11:49:49.000Z","dependencies_parsed_at":"2025-08-18T13:39:48.892Z","dependency_job_id":null,"html_url":"https://github.com/UnifyKitHQ/chrome-codespaces-container","commit_stats":null,"previous_names":["unifykithq/chrome-codespaces-container"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/UnifyKitHQ/chrome-codespaces-container","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnifyKitHQ%2Fchrome-codespaces-container","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnifyKitHQ%2Fchrome-codespaces-container/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnifyKitHQ%2Fchrome-codespaces-container/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnifyKitHQ%2Fchrome-codespaces-container/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UnifyKitHQ","download_url":"https://codeload.github.com/UnifyKitHQ/chrome-codespaces-container/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnifyKitHQ%2Fchrome-codespaces-container/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271400259,"owners_count":24752830,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["codespaces","containerized-applications","google-chrome","google-chrome-container","web-browser-container"],"created_at":"2025-08-20T23:13:21.904Z","updated_at":"2025-08-20T23:13:22.699Z","avatar_url":"https://github.com/UnifyKitHQ.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chrome Codespaces Container\n\nA containerized Google Chrome development environment designed specifically for **GitHub Codespaces** that runs in a VNC-enabled container with a web-based interface. This project provides a complete Chrome browser environment that can be accessed through any web browser, making it ideal for development, testing, and remote access scenarios within GitHub Codespaces.\n\n## 🚀 Features\n\nNote: This container only supports x86-64 Chrome as Google does not provide native builds for ARM64 Linux.\n\n- **Containerized Chrome**: Google Chrome running in a Docker container\n- **Web-based Access**: Access Chrome through any web browser via noVNC\n- **VNC Support**: Full VNC server for remote desktop access\n- **Privacy-Focused**: Pre-configured Chrome policies for enhanced privacy\n- **Development Ready**: Includes development tools and extensions support\n- **Persistent Data**: Chrome profile data persists across container restarts\n- **No Sandbox Mode**: Optimized for containerized environments\n\n## 🏗️ Architecture\n\nThis project uses a multi-layered approach:\n\n1. **Base Image**: Debian Trixie (slim)\n2. **VNC Server**: TigerVNC for remote desktop access\n3. **noVNC**: Web-based VNC client for browser access\n4. **Desktop Environment**: Openbox window manager\n5. **Chrome Browser**: Google Chrome with custom policies\n\n### Port Configuration\n\n- **Port 6901**: noVNC web interface (primary access method)\n- **Port 5901**: Direct VNC access (for VNC clients)\n\n## 📋 Prerequisites\n\n- GitHub Codespaces access\n- Modern web browser for accessing the noVNC interface\n\n## 🛠️ Setup Instructions\n\n### GitHub Codespaces Setup\n\n1. **Fork or Clone the repository**:\n   - Fork this repository to your GitHub account, or\n   - Clone it locally if you have access\n\n2. **Open in GitHub Codespaces**:\n   - Navigate to the repository on GitHub\n   - Click the green \"Code\" button\n   - Select \"Codespaces\" tab\n   - Click \"Create codespace on main\" (or your desired branch)\n\n3. **Wait for container startup**:\n   - The codespace will build and start automatically\n   - VNC and noVNC services will initialize\n   - You'll see the container building in the terminal\n\n## 🌐 Accessing Google Chrome\n\nAfter the GitHub Codespace is running, follow these steps to access Google Chrome:\n\n### Step-by-Step Instructions\n\n1. **Go to Ports**:\n   - In VS Code, click on the \"Ports\" tab in the bottom panel\n   - Or use the Command Palette: `Ports: Focus on Ports View`\n\n2. **Open the Web Interface**:\n   - Click on the **globe icon** next to port **6901**\n   - This will open the noVNC interface in your browser\n\n3. **Access the VNC Interface**:\n   - In the opened browser tab, click on the **`vnc.html`** file\n   - Click the **\"Connect\"** button to establish the VNC connection\n\n4. **Launch Google Chrome**:\n   - Right-click on the desktop in the VNC interface\n   - Hover over **Applications** → **Internet** → **Google Chrome**\n   - Click to launch Chrome\n\n## ⚙️ Configuration\n\n### Chrome Policies\n\nThe container includes pre-configured Chrome policies located in `.devcontainer/chrome_policies.json`:\n\n- **Privacy Enhanced**: Disabled telemetry and data collection\n- **Developer Mode**: Enabled extension developer mode\n- **Security**: Enhanced safe browsing and cookie policies\n- **Performance**: Memory saver and high efficiency modes enabled\n\n### Customization\n\nTo modify Chrome behavior, edit `.devcontainer/chrome_policies.json` and rebuild the container.\n\n## 🔧 Development Features\n\n- **Extension Support**: Developer mode enabled for Chrome extensions\n- **File System Access**: Persistent Chrome profile data\n- **Network Access**: Full internet connectivity\n- **Shared Memory**: Optimized for Chrome's memory requirements\n\n## 📁 Project Structure\n\n```\nchrome-container/\n├── .devcontainer/\n│   ├── Containerfile         # Docker container definition\n│   ├── devcontainer.json     # VS Code Dev Container configuration\n│   ├── start.sh              # Container startup script\n│   └── chrome_policies.json  # Chrome browser policies\n├── LICENSE                   # GNU GPL v3 License\n└── README.md                 # This file\n```\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n1. **Codespace Build Issues**:\n   - Ensure you have sufficient GitHub Codespaces quota\n   - Check the build logs in the terminal for errors\n   - Try rebuilding the codespace if needed\n\n2. **Chrome Won't Start**:\n   - Check the terminal output for any error messages\n   - Verify the VNC services are running properly\n   - Restart the codespace if necessary\n\n3. **VNC Connection Issues**:\n   - Ensure port forwarding is working correctly\n   - Try accessing via different browser\n   - Check if the noVNC interface is accessible\n\n4. **Performance Issues**:\n   - Codespaces have predefined resource limits\n   - Consider upgrading to a larger codespace machine type if available\n\n### Logs and Debugging\n\nView build and runtime logs:\n- Check the terminal output in the codespace\n- Look for any error messages during startup\n- Monitor the VNC and noVNC service status\n\nAccess container shell:\n- Use the integrated terminal in the codespace\n- All commands run within the container environment\n\n## 📄 License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Test thoroughly\n5. Submit a pull request\n\n## 📞 Support\n\nFor issues and questions:\n- [Open an issue on GitHub](https://github.com/UnifyKitHQ/chrome-codespaces-container/issues)\n- Check the troubleshooting section above\n- Review container logs for error details\n\n---\n\n**Note**: This container runs Chrome with `--no-sandbox` for compatibility with containerized environments. This is safe for development and testing but should be used with caution in production environments. The container only supports x86-64 Chrome because Google does not provide native builds for ARM64 Linux.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funifykithq%2Fchrome-codespaces-container","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funifykithq%2Fchrome-codespaces-container","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funifykithq%2Fchrome-codespaces-container/lists"}