EDGE License & Setup
GetPageSpeed EDGE serves traffic with a valid Ultra license token installed at /etc/edge/license.jwt. Generating and installing one takes about two minutes.
Install your license token in 3 steps
Generate the token in your client area
Sign in at getpagespeed.com/client-area/ with your subscription ID (in your welcome email or payment confirmation). Open the License Token tab and click Generate Token. Copy the long eyJ... string. EDGE requires an Ultra subscription — get Ultra here if you don't have one yet.
Lost the token? Regenerate — it's free and invalidates the previous one; update every server that used the old token.
Drop the token onto the server
Save it to /etc/edge/license.jwt, readable by the edge service user:
sudo tee /etc/edge/license.jwt > /dev/null <<'EOF' PASTE_YOUR_TOKEN_HERE EOF sudo chown root:edge /etc/edge/license.jwt sudo chmod 640 /etc/edge/license.jwt
Permissions matter: EDGE workers run as the edge user. A root-only (600 root:root) token file reads as license missing even though the file exists.
Restart and verify
sudo /usr/sbin/edge -t && sudo systemctl restart edge sudo grep gps_license /var/log/edge/error.log | tail -5
No fresh gps_license errors (or a validated license tier=ultra notice) means the token is accepted and EDGE is serving.
What the notice you saw means
License missing
No token at /etc/edge/license.jwt — or the file isn't readable by the edge service user (see the permissions note above). Follow the 3 steps to install one.
License invalid
The token isn't a valid Ultra token: it may be truncated on paste, generated for a different product tier, or corrupted. Regenerate it in the client area under an active Ultra subscription and reinstall.
License expired
The token's validity window has passed. Sign in to the client area, generate a fresh token, and replace /etc/edge/license.jwt. If your subscription itself lapsed, restart Ultra first.
License revoked
This token was invalidated — usually because a newer token was generated, or the subscription ended. Generate a current token from an active Ultra subscription and install it. Questions? info@getpagespeed.com.
Server quick reference
| Main configuration | /etc/edge/edge.conf (drop-ins: /etc/edge/conf.d/*.conf) |
|---|---|
| Tuning profiles | /etc/edge/edge-profiles/ — microcache.conf, tls.conf, ratelimit.conf; each documents its own wiring, see the bundled README.md |
| License token | /etc/edge/license.jwt (root:edge, mode 640) |
| Service | systemctl enable --now edge · config test: /usr/sbin/edge -t · reload: systemctl reload edge |
| Logs | /var/log/edge/error.log, /var/log/edge/access.log |
| Install | See the EDGE page — dnf install edge from the Ultra-authorized getpagespeed-extras-edge channel |
Enable a profile by including it in the http {} block of /etc/edge/edge.conf, e.g. include /etc/edge/edge-profiles/microcache.conf; — then wire the documented location snippet into your server {}.
Priority support is part of your Ultra plan: info@getpagespeed.com.