Modernize linux-quick-start
- Use https everywhere
- Point to chromium.googlesource.com instead of code.google.com
- Point to the current location of the manageable policies list
- Call scp with -r since the suggestion is to copy a directory
- Remove syntax highlighting hints, it is not supported
- Remove leading '>' from shell commands to prevent confusion
- Use a different policy name in the example to avoid confusion; most
people will think that "HomepageLocation" will change the default home
page, but it actually sets the page that will be open when the user
wants to open a home page on startup. Use the "ShowHomeButton" policy
instead since that one is easier to verify
Change-Id: I60d88773eae708c6887507162fb2cab7904605b2
Reviewed-on: https://chromium-review.googlesource.com/c/website/+/3899081
Reviewed-by: Daniel Cheng <dcheng@chromium.org>
Auto-Submit: Raphael Kubo Da Costa <raphael.kubo.da.costa@intel.com>
Commit-Queue: Daniel Cheng <dcheng@chromium.org>
diff --git a/site/administrators/linux-quick-start/index.md b/site/administrators/linux-quick-start/index.md
index 6165d87..0e4c808 100644
--- a/site/administrators/linux-quick-start/index.md
+++ b/site/administrators/linux-quick-start/index.md
@@ -13,22 +13,21 @@
Depending on your network's requirements, you may either want to deploy Chromium
or Google Chrome. The differences are described
-[here](http://code.google.com/p/chromium/wiki/ChromiumBrowserVsGoogleChrome).
+[here](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/chromium_browser_vs_google_chrome.md).
There are several different ways to get the browser:
* If you want to deploy Google Chrome, download Google Chrome
- [here](http://www.google.com/chrome/eula.html?platform=linux&hl=en&hl=en).
+ [here](https://www.google.com/chrome).
* If you want to deploy Chromium, your distro may have already
repackaged Chromium for you. See which distros have repackaged
Chromium
- [here](http://code.google.com/p/chromium/wiki/LinuxChromiumPackages).
+ [here](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/linux/chromium_packages.md).
* If you want to deploy Chromium but you want to build it yourself,
follow the instructions on building Chromium
- [here](http://code.google.com/p/chromium/wiki/LinuxBuildInstructions).
+ [here](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/linux/build_instructions.md).
At the end of this process, you should have Google Chrome or Chromium installed.
-Verify that the version you are running is **later than 6.0.444.0**.
**Set Up Policies**
@@ -36,48 +35,49 @@
**/etc/opt/chrome** for Google Chrome (note the lack of **opt** for Chromium).
There are two sets of policies kept in these directories: one set that is
required and mandated by an administrator, and one set that is recommended for
-users but not required. These two sets live at:
+users but not required. For Google Chrome, these two sets live at (remember
+that the paths differ for Chromium):
-/etc/opt/chrome/policies/managed/
-
-/etc/opt/chrome/policies/recommended/
+* /etc/opt/chrome/policies/managed/
+* /etc/opt/chrome/policies/recommended/
Create these directories if they do not already exist:
-```none
->mkdir /etc/opt/chrome/policies
->mkdir /etc/opt/chrome/policies/managed
->mkdir /etc/opt/chrome/policies/recommended
+```
+mkdir /etc/opt/chrome/policies
+mkdir /etc/opt/chrome/policies/managed
+mkdir /etc/opt/chrome/policies/recommended
```
Make sure that the files under /managed are not writable by non-admin users;
otherwise, they could just overwrite your policies to get the configuration they
want!
-```none
->chmod -w /etc/opt/chrome/policies/managed
+```
+chmod -w /etc/opt/chrome/policies/managed
```
To set policies that are required, create a file named "test_policy.json" in
/etc/opt/chrome/policies/managed/
-```none
->touch /etc/opt/chrome/policies/managed/test_policy.json
+```
+touch /etc/opt/chrome/policies/managed/test_policy.json
```
In this file, put the following content:
-```none
+```
{
- "HomepageLocation": "www.chromium.org"
+ "ShowHomeButton": true
}
```
-That's it! The next time you start Google Chrome on that machine, the home page
-will be locked to this value.
+That's it! The next time you start Google Chrome on that machine, the home
+button next to the location bar (which is not shown by default) will be shown
+and locked to this value.
To see what other policies you can control, review the [exhaustive list of all
-manageable policies](/administrators/policy-list-3).
+manageable policies](https://chromeenterprise.google/policies/).
You can spread your policies over multiple JSON files. Chrome will read and
apply them all. However, you should not be setting the **same** policy in more
@@ -96,8 +96,8 @@
/etc/opt/chrome/policies/managed/ on all the target machines. You could do this
simply by scp'ing the files to the target:
-```none
->scp /etc/opt/chrome/policies adminusername@targetmachine:/etc/opt/chrome
+```
+scp -r /etc/opt/chrome/policies adminusername@targetmachine:/etc/opt/chrome
```
Similarly, use whatever file-pushing utility or script to push out Google Chrome
