https://github.com/tibor309/brave
🦁 Brave browser accessible trough another web browser
https://github.com/tibor309/brave
brave brave-browser container docker kasm kasmvnc linux web-browser
Last synced: 9 months ago
JSON representation
🦁 Brave browser accessible trough another web browser
- Host: GitHub
- URL: https://github.com/tibor309/brave
- Owner: tibor309
- License: gpl-3.0
- Created: 2024-02-17T11:27:27.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-17T07:59:05.000Z (over 1 year ago)
- Last Synced: 2025-02-17T08:33:57.276Z (over 1 year ago)
- Topics: brave, brave-browser, container, docker, kasm, kasmvnc, linux, web-browser
- Language: Dockerfile
- Homepage:
- Size: 47.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 🦁 [Brave](https://github.com/tibor309/brave)
This container allows you to use the [Brave](https://brave.com/) web browser trough another web browser using KasmVNC. Brave is a fast, private and secure web browser for PC, Mac and mobile.
## Setup
To set up the container, you can use docker-compose or the docker cli. Unless a parameter is flagged as 'optional', it is *mandatory* and a value must be provided. This container is using a linuxserver.io base, so you can use their [mods](https://github.com/linuxserver/docker-mods) and configurations to enable additional functionality within the container.
> [!NOTE]
> This image is also available on [Docker Hub](https://hub.docker.com/r/tibordev/brave) under `tibordev/brave`.
### [docker-compose](https://docs.linuxserver.io/general/docker-compose) (recommended)
```yaml
---
services:
brave:
image: ghcr.io/tibor309/brave:latest
container_name: brave-browser
security_opt:
- seccomp:unconfined #optional
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
- BRAVE_CLI=https://www.github.com/ #optional
volumes:
- /path/to/config:/config
ports:
- 3000:3000
- 3001:3001
shm_size: "1gb"
restart: unless-stopped
hostname: brave #optional
```
### [docker-cli](https://docs.docker.com/engine/reference/commandline/cli/)
```bash
docker run -d \
--name=brave-browser \
--security-opt seccomp=unconfined `#optional` \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=Etc/UTC \
-e BRAVE_CLI=https://www.github.com/ `#optional` \
-p 3000:3000 \
-p 3001:3001 \
-v /path/to/config:/config \
--shm-size="1gb" \
--restart unless-stopped \
--hostname brave `#optional` \
ghcr.io/tibor309/brave:latest
```
## Security
By default, this container has no authentication. Configure the optional environment variables `CUSTOM_USER` and `PASSWORD` to enable basic HTTP auth. This should only be used to locally secure the container on a local network. If you're exposing this container to the internet, it's recommended to use a reverse proxy or a VPN such as [SWAG](https://github.com/linuxserver/docker-swag) or Tailscale.
## Config
Containers are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `:` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container. Further options can be found on the [KasmVNC Base Images](https://github.com/linuxserver/docker-baseimage-kasmvnc#options) repo.
| Parameter | Function |
| :----: | --- |
| `-p 3000` | HTTP Brave desktop gui. |
| `-p 3001` | HTTPS Brave desktop gui. |
| `-e PUID=1000` | For UserID |
| `-e PGID=1000` | For GroupID |
| `-e TZ=Etc/UTC` | Specify a timezone to use, see this [list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List). |
| `-e BRAVE_CLI=https://www.github.com/` | Specify one or multiple [Brave CLI flags](https://support.brave.com/hc/en-us/articles/360044860011-How-Do-I-Use-Command-Line-Flags-in-Brave), this string will be passed to the application in full. |
| `-v /config` | Users home directory in the container, stores local files and settings. |
| `--shm-size=` | This is needed for any modern website to function like YouTube. |
| `--security-opt seccomp=unconfined` | For Docker Engine only, many modern gui apps need this to function on older hosts as syscalls are unknown to Docker. |
| `--hostname brave` | Hostname for the container. It is advised to change this to your own if you're planning to use Brave Sync. |
## Updating
This image is updated monthly. To update the app, you'll need to pull the latest image and redeploy the container with your configuration. It's **not** recommended to update the app inside the container. Updating this way could cause issues with configurations and mods.
## Usage
To access the container, navigate to the IP address for your machine with the port you provided at the setup.
* [http://yourhost:3000/](https://www.youtube.com/watch?v=dQw4w9WgXcQ)
* [https://yourhost:3001/](https://www.youtube.com/watch?v=dQw4w9WgXcQ)