Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 22 additions & 5 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,11 +47,28 @@ We will then take care of the issue as soon as possible.
> When contributing to this project, you must agree that you have authored 100% of the content, that you have the necessary rights to the content and that the content you contribute may be provided under the project license.

### Building locally

> [!NOTE]
> These steps can also be done in a distrobox (or any other container software) if preferred

#### Setup
Download and run copr_script.sh:
Enable the COPR repository (as root):

`dnf copr enable secureblue/hardened-chromium`

Install the `chromium-clean-source` package (as root):

`dnf install chromium-clean-source`

> This command can take a while especially on a slow network, the package is over 3 gigabytes

Clone the repository:

`git clone https://github.com/secureblue/hardened-chromium.git`

Then run the COPR script:

`wget https://raw.githubusercontent.com/secureblue/hardened-chromium/master/copr_script.sh`
`./copr_script.sh`
`/bin/bash ./hardened-chromium/copr_script.sh`

#### Build RPM
Build the patched chromium source from the spec file:
Expand All @@ -69,7 +86,7 @@ Install the built rpm...

A good pull request should be ready for review before it is even created. For all pull requests, ensure:

- Your changes passes all the checks
- Your commit is signed
- Your changes passes all checks
- Your commits are signed
- You have no unnecessary changes, including whitespace changes
- For substantive changes, you include evidence of proper functionality in the pull request in addition to the build results.
11 changes: 5 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,16 +23,15 @@ Official support is only provided via [secureblue](https://github.com/secureblue

## Post-install

The following flags are available that provide additional hardening but may cause breakage:
Some additions preferences are added to `chrome://settings/security`, these provide addition security and privacy controls should they be needed. There is also a Website Dark Mode preference added to `chrome://settings/appearance`.
\
\
Additionally, the following flags are available that provide extra hardening but may cause breakage or usability issues:

- `chrome://flags/#enable-network-service-sandbox`
- `chrome://flags/#show-punycode-domains`
- `chrome://flags/#disable-cross-origin-referrers`

The following flags are also provided for convenience if you need them:

- `chrome://flags/#incognito-launch`
- `chrome://flags/#extensions-support`
Other flags are also provided for compatibility should you experience an issue related to some of the hardening enabled by default.

## Contributing

Expand Down